 |
» |
|
|
|
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. 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. There cannot be two logging identifiers with the same name
on the system at the same time. The LISTLOG
command can be used to determine what logging identifiers currently
exist. Use | |
This command may be issued from a session, job, program, or
in BREAK. Pressing Break has
no effect on this command. User logging (LG) capability is required
to use this command. Example | |
To create the logging identifier FINANCE
and associate it with the disk log file A,
enter: GETLOG FINANCE;LOG=A,DISC |
Related Information | |
- Commands
ALTLOG,
CHANGELOG, LISTLOG,
OPENLOG, RELLOG,
LOG, SHOWLOG,
SHOWLOGSTATUS - Manuals
System Startup, Configuration, and Shutdown
Reference Manual User Logging Programmer's Guide
|
