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