HP 3000 Manuals HP 3000 Manuals
GETLOG
Establishes a logging identifier on the system.
Syntax
{,DISC }
GETLOG logid;LOG=logfile {,TAPE } [;PASS=password][{;AUTO }]
{,SDISC} [{;NOAUTO}]
{,CTAPE}
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 (32650-90042)
User Logging Programmer's Guide (32650-60012)