GETLOG

Generated from C.70.00 /SYS/PUB/CICAT last modified on Mon Feb 16 17:55:04 2004

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, OPENLOG, RELLOG

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

            User Logging Programmer's Guide (32650-60012)