Chapter 8 677
Command Definitions SP-Z
SWITCHLOG
SWITCHLOG
Closes the current system log file, then creates and opens a new one. (Native Mode)
Syntax
SWITCHLOG
Parameters
None.
Operation Notes
When the SWITCHLOG command is executed, MPE/iX displays the previous system log file
number (xxx), the percentage of file space used (yy), and the current open log file (zzz), as
shown in the following example:
SYSTEM LOG FILE #xxx IS yy% FULL
SYSTEM LOG FILE #zzz IS ON
If this command is issued and logging is not active the following message is displayed:
NO LOGGING
LOG FILE xxx IS yy% FULL
NOTE Do not create new log files with the BUILD command since MPE/iX creates
them automatically. If you use the BUILD command to create a new log file
and then attempt to switch the current log file to the file you created, user
logging suspends in an error state and the following message is displayed:
SYSTEM LOG FILE #xxx ENCOUNTERED ERROR #nnn
LOGGING SUSPENDED.
Use
This command may be issued from a session, job, program, or in BREAK. Pressing Break
has no effect on this command. System supervisor (OP) capability is required to use this
command.
Example
To switch logging to a new log file, enter:
SWITCHLOG
Related Information
Commands CHANGELOG, RESUMELOG
Manuals SPU Switchover/XL User's Guide
