HP 3000 Manuals HP 3000 Manuals
CHANGELOG
Changes the user logging file without stopping or interrupting the
logging process.
Syntax
CHANGELOG logid [;DEV=device]
Parameters
logid Name of the currently active user logging process.
This name may contain from one to eight
alphanumeric characters, beginning with an
alphabetic character.
device Name of the device on which the new logging file is
to be created. The device may be either DISC or
TAPE. Default is DISC.
Operation Notes
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:
Log file for logid AAA has been changed from
A001.PUB.SYS to A002.PUB.SYS (ulogmsg 38)
If the new logging file is a serial file, a message advising the operator
to mount the new log file appears on the console:
Mount new tape volume for changelog of logid AAA
(ulogmsg 40).
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:
Current File Next File
TEST001 TEST002
TEST002 TEST003
... ...
TEST998 TEST999
TEST999 TEST000
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.
NOTE The logging process specified by logid must be in an ACTIVE state.
If the logging process is in any other state, such as RECOVERING,
STOP, INITIALIZING, or if the logging process has another CHANGELOG
pending, the command terminates in an error state. The ALTLOG
command permits changing the log file for an inactive logging
process. ALTLOG, however, does not provide a way to link log files
into a set.
Use
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.
Example
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:
CHANGELOG KATHY
Related Information
Commands ALTLOG, GETLOG, LISTLOG, LOG, OPENLOG, RELLOG, SHOWLOG,
SHOWLOGSTATUS
Manuals User Logging Programmer's Guide (32650-60012)