Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Establishes a logging identifier on the system.
GETLOG logid;LOG=logfile[{,DISC} {,TAPE} {,SDISC} {,CTAPE} [;PASS=password] [{;AUTO }] {;NOAUTO}
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.
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.
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.
To create the logging identifier FINANCE and associate it with the disk log file A, enter GETLOG FINANCE;LOG=A,DISC
Commands: ALTLOG, LISTLOG, OPENLOG, RELLOG Manuals : System Startup, Configuration and Shutdown Reference Manual (32650-90042) User Logging Programmer's Guide (32650-60012) Back to Main Index