NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
LOGSWAP
NonStop NET/MASTER MS Commands
115412 Tandem Computers Incorporated 2–151
LOGSWAP The LOGSWAP command stops logging to the current activity log file and opens
another activity log file in the group of activity log files. (The next available log file
may be the same as the current activity log file if only one file is available in the
group.) The activity log is a chronological record of all important activity. The
LOGPROC NCL procedure (if active) intercepts and processes messages sent to the
log. A user can browse through the activity log online using Log Browse. Entering the
LOGSWAP command with no operands swaps to the next available activity log file in
the group of activity log files.
LOGSWAP [ log-file-number ]
log-file-number
specifies the number of the log file to use as the next activity log file. You must
specify a number from 1 through 9.
Considerations
The default authority level of this command is 3.
You can enter this command from any NCL procedure, including the INIT NCL
procedure, by using either the CMD core statement or the INTCMD verb.
You can specify a maximum of nine activity log files in the group of available files:
The PARAM LOGFILE1 command specifies the first activity log file. This file
holds messages logged during NonStop NET/MASTER MS startup.
After NonStop NET/MASTER MS startup, you can use the SYSPARMS
LOGFILEn command to specify the name and number of a maximum of nine
files (n is a number from 1 through 9) in a group of activity log files. (If
additional files are not specified, the only log file used by NonStop
NET/MASTER MS is the file specified by the PARAM LOGFILE1 command.)
There are three ways to stop logging to the current activity log file and to swap to
the next file in the group of activity log files:
Manually, using the LOGSWAP command without a log file number. This
swaps to the next available activity log file. The next available log file may be
the same as the current activity log file if only one file is available in the group.
Manually, using the LOGSWAP command with a log file number. This swaps
to a new specific activity log file.
Automatically by NonStop NET/MASTER MS. This occurs when the current
activity log file fills to capacity or an error occurs on the file.
The setting of the SYSPARMS LOGWRAP command is disregarded when using
the LOGSWAP command to manually swap log files.