GETLOG


GETLOG

     Establishes a logging identifier on the system. (CM)

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, that is
DISC, TAPE, SDISC (serial disk) or CTAPE (cartridge
tape).

password Logging identifier password, optionally 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 will not be performed if the log file
becomes full.


OPERATION

     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 data bases, so
that each test task that runs will write to a logging file.
Therefore, data recovery is 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.
Note that if a password is specified, it will be 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" (e.g.
fname001). This naming convention works in conjunction with
the file set number to generate sequential file names
automatically.

This command may be issued form a session, job, program, or
in BREAK. Pressing [Break] has no effect on this command. It
requires User Logging (LG) capability.

NOTE

If a new log file name is specified with the ALTLOG command, the links
with any previous log file will be 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 find out
what logging identifiers currently exist.


EXAMPLE(S)

     To create the logging identifier FINANCE and associate it
with the disk log file A, enter

GETLOG FINANCE;LOG=A,DISC

ADDITIONAL INFORMATION

Commands:   ALTLOG, LISTLOG, RELLOG

Manuals : System Startup, Configuration and Shutdown Reference
Manual (32650-90042)

User Logging Programmer's Guide (32650-60012)