|
|
MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 3 Command Definitions C-E CHANGELOG |
|
Changes the user logging file without stopping or interrupting the logging process.
This command permits the user to change the active logging file without stopping the logging process with the LOG logid, STOP command. By specifying a device, you may switch the logging file from one device to another, regardless of the device on which the logging file was created. If you enable automatic logging with the ALTLOG or GETLOG command, however, the only device available for logging is the default, DISC. If a log file is restricted to a single volume or volume class when it is created with the BUILD command, then successive log files created by User Logging will have the same restriction. If the CHANGELOG command is valid, the system writes a changelog record to the end of the current logging file and closes the file. It then opens a new logging file whose characteristics are identical to those of the preceding file and makes the new file permanent. If the system is unable to open a new file of the same size, it tries to open a new file half the size of the old file. It repeats this process until a new file is opened successfully, or until the size is less than 256 records. In the second case, user logging terminates. If the system opens a new log file, it immediately writes a changelog record to the new file. The changelog record posted to the old logging file contains the fully qualified identifier of the new logging file. A corresponding changelog record written to the new file contains the fully qualified identifier of the old logging file. Changelog records also contain the device type of the logging file to which the changelog refers. The following message is displayed on the $STDLIST to confirm a successful change:
If the new logging file is a serial file, a message advising the operator to mount the new log file appears on the console:
Normally when a user logging file is full, the system terminates the logging process and displays an appropriate message. However, by specifying the AUTO parameter in a GETLOG or ALTLOG command, you enable an automatic CHANGELOG, thereby eliminating the need to issue the CHANGELOG command manually. Refer to the ALTLOG and GETLOG commands in this chapter. To use CHANGELOG (manually or automatically), end the first user logging file name with the numeric characters 001 (for example, fname001). This establishes a naming convention that works in conjunction with the file set number to generate sequential file names independently. New file names consist of the file name root (fname) plus the next sequential increment of the last three digits:
The logging process opens files, and automatically names them with the next sequential number, up to a maximum of 999. Thereafter, the numbering sequence resets to 000 and begins incrementing all over again. Automatic logging with the CHANGELOG command is available only for disk files.
This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. You must be the logid creator or have system manager (SM) or system supervisor (OP) capability to use the CHANGELOG command. User logging (LG) capability is also required. If you are running a logging process with a logid of KATHY, logging to logfile KLOG001, and you want to close the current logfile and log to a new logfile, KLOG002, without interrupting the logging process, enter:
|
|