Chapter 4 275
Command Definition F-K
GETLOG
GETLOG
Establishes a logging identifier on the system.
Syntax
GETLOG
logid;LOG=logfile{ ,DISC ,TAPE ,SDISC ,CTAPE } [ ;PASS=password][{ ;AUTO
;NOAUTO } ]
Parameters
logid The logging identifier to be established. This 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. It must
contain from one to eight alphanumeric characters, beginning with an
alphabetic character. You must also specify the device class on which the
log file resides, DISC, TAPE, SDISC (serial disk) or CTAPE (cartridge tape).
password Logging identifier password, assigned by the creator for protection against
illegal use of a particular identifier. The password must contain from one
to eight alphanumeric characters, beginning with an alphabetic character.
The password is optional. if ;PASS= is entered without a password none is
assigned.
AUTO Initiates an automatic CHANGELOG if the log file becomes full. This option
is ignored if TAPE is specified.
NOAUTO Prevents initiation of an automatic CHANGELOG. A CHANGELOG is not
performed if the log file becomes full.
Operation Notes
The GETLOG command specifies a logging identifier to be used each time a particular
logging process is used. Frequently the GETLOG command is used with databases, so that
each test task that runs writes to a logging file. This makes data recovery easier because
you know where the task failed.
The creator of the logging identifier must have user logging (LG) or system supervisor (OP)
capability to execute this command. Other users can be allowed access to this logging
identifier by notifying them of the identifier and password. If a password is specified, it is
required whenever the logging process is accessed. Users accessing the logging system
with this identifier must supply the identifier and password in the OPENLOG intrinsic.
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.
