Filter
Top Products
64 Chapter 2
Command Definitions A-B
ALTLOG
ALTLOG
Alters the attributes of an existing user logging identifier.
Syntax
ALTLOG logid [ ;LOG=logfile { ,DISC ,TAPE } ] [ ;PASS=password[ { ;AUTO ;NOAUTO } ]
Parameters
logid The logging identifier whose attributes are to be changed. This identifier
must contain from one to eight alphanumeric characters, beginning with
an alphabetic character.
logfile The name of the file to receive data from the logging procedure. This name
must contain from one to eight alphanumeric characters, beginning with
an alphabetic character. You must specify the device class on which log file
resides, either DISC or TAPE.
password The new password for the logging identifier. This password must contain
from one to eight alphanumeric characters, beginning with an alphabetic
character.
AUTO Initiates an automatic CHANGELOG if the current log file becomes full. This
option is ignored is TAPE is specified. Refer to the CHANGELOG command.
NOAUTO Prevents the initiation of an automatic CHANGELOG. A CHANGELOG is not
performed if the current log file becomes full. Default.
Operation Notes
This command changes the attributes of an existing user logging identifier to those
specified in the parameter list. Parameters not included in the ALTLOG command retain
their current values. System supervisor (OP) or user logging (LG) capability is required to
use this command. Only the creator of the logging identifier can alter its attributes.
To use the AUTO parameter, the log process for logid must be enabled for changing. You
may do this by ending the log file name with the numeric characters 001 (for example,
fname001). This naming convention works in conjunction with the file set number to
generate sequential file names automatically.
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 a new log file name is specified with the ALTLOG command, the links with any previous
log file are broken.