openUTM logs messages to the system files SYSOUT and/or SYSLST i.e. openUTM writes all UTM messages with the UTM message destination SYSOUT or SYSLST to these files (see the openUTM manual
“Messages, Debugging and Diagnostics on BS2000 Systems” for information on message destinations). These system files should therefore be redirected to separate process-specific files.
You can switch these system files automatically during live operation. After you have switched the files, the old SYSOUT and SYSLST files can be evaluated and, if necessary, deleted in order to reduce the amount of disk space occupied.
After the BS2000 commands SET-SYSOUT-READ-MARK and SET-SYSLST-READ-MARK you can also access the system files that are still open (see “BS2000 OSD/BC commands” manual).
Switching system files
The system files can be switched over during live operation either by administration or at definable periodic intervals. The system files for all tasks of a UTM application are always switched over together, but the precise time at which this is done for individual tasks may be delayed when the system is under load.
To switch the files over by administration
use the command KDCAPPL SYSPROT=NEW
use the sysprot_switch in the kc_diag_and_account_par_str data structure of the programming interface (see the openUTM manual “Administering Applications”)
use WinAdmin/WebAdmin
The system files are switched over as soon as possible after the request has been made.
To switch over the system files using a time interval, specify the start parameter SYSPROT when starting UTM application (see section "Start parameters for openUTM"). You can specify a time interval in days. The files are always switched over at midnight.
If an error occurs when switching the files over, an error message is issued and time-controlled switching is deactivated.
Names of the switched files
When the UTM application is started, the system files are set up using the names specified either by the system or the user. Files are generated using the following name formats as of the first time that the files are switched over manually or automatically:
SYSOUT: <prefix>.O.YYMMDD.HHMMSS.TSN
SYSLST: <prefix>.L.YYMMDD.HHMMSS.TSN
The maximum total length of the new path name for a file that has been switched over is 54 characters and is made up as follows:
[:catid:][$userid.]filename-prefix.datei-suffix
<---6---><---10---><------17----->.<----21---->
<prefix>
The prefix is made up of
catid, userid
Catalog ID and user ID under which the UTM application was started.
catid and userid can be omitted.
filename-prefix
The prefix you specified for the start parameter SYSPROT when starting the UTM application (see section "Start parameters for openUTM").
The file name prefix can be a maximum of 17 characters in length.
Default value for <prefix>:
Name of the application specified in MAX APPLINAME during KDCDEF generation.
YYMMDD.HHMMSS
Date and time of the switchover
TSN
TSN of the task