openUTM logs messages to the system files stderr and/or stdout.
You can switch these system files during live operation. After you have switched the files, the old stderr and stdout files can be evaluated and, if necessary, deleted in order to reduce the amount of disk space occupied.
Switching system files
The system files can be switched over during live operation either by the administrator or at definable periodic intervals. The system files are always switched over together.
To switch the files over as administrator
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 parameter file of the application"). You can specify a time interval in days. The files are always switched over at midnight.
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:
stdout: prefix.out.YY-MM-DD.HHMMSS
stderr: prefix.err.YY-MM-DD.HHMMSS
prefix
The prefix you specified for the start parameter SYSPROT when starting the UTM application (see section "Start parameters for openUTM").
Default: utmp
YY-MM-DD.HHMMSS
Date and time of the switchover
If you set the environment variable UTM_REDIRECT_FILES to YES (see "General environment variables for openUTM"), the files are switched over immediately the UTM application is started and output is sent to the files with names corresponding to the formats shown above. Output is not written to the existing system files stdout / stderr or to their redirection destinations.