MPE/iX Commands Reference Manual (32650-90877)

Chapter 6 229
Command List IV
Commands FCOPY thru GETRIN
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
GETRIN
Acquires a global resource identification number (RIN) and assigns a password to it.