CONSOLE-LOG

File 25
Statement FIND
Task Retrieve current and past console log data, for example, start and end of jobs and tasks, as well as important error and abend messages.

Fields

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
DATA-SET N5   D  
LOG-TIME A8   D  
LOG-TEXT A128   D  
LOG-ROUTE-CODE A8   D  
LOG-RECORD-TYPE A1   D  
LOG-REQUEST-TYPE A1   D  
LOG-DATX D   D  
LOG-TIMX T   D  
RECORD-NUMBER N9   D  
RECORD-LENGTH N3   D  
RECORD A253   D  
POSITION B1   D  
TOKEN-VECTOR A225   D  
NUMBER-OF-TOKENS N3   D  
TOKEN-DELIMITERS A10   D  
SCAN A3   D  
SCAN-LIMIT N7   D  
SCAN-TYPE A1   D  
SCAN-LENGTH N3   D Relevant with SCAN-TYPE=A.
SCAN-COLUMN-FROM N3   D Relevant with SCAN-TYPE=A.
SCAN-COLUMN-TO N3   D Relevant with SCAN-TYPE=A.
DATA-SET-KEY N11   D  
LOG-JOB-NUMBER N7   D  
LOG-JOB-NAME A8   D  
LOG-REPLY-ID A8   D  
LOG-SOURCE A8   D  

Relevant Error Codes

Code Text
533 Requested number or records scanned.
537 Time limit reached.
699 GETVIS failed.
711 Logical Error occurred in Common JES Interface.
712 Request to Common JES Interface failed.
717 GENCB for ACB or RPL failed with RC:1:and RSN:2:
719 Unable to :1: SYSOUT dataset.
724 Requested job not found.
731 Error occurred during spool GET, RPLFDBK :1:
781 Unable to obtain storage for work area extension.
830 JES interface not active.

Field Descriptions

Field Name Format/Length
DATA-SET (N5)

Requested dataset number of job SYSLOG.

Field Name Format/Length
DATA-SET-KEY (N1)

Unique dataset identification, offering much faster access than the dataset number. The dataset key can be obtained from the SPOOL-FILES view using job name SYSLOG.

Field Name Format/Length
LOG-DATX (D)

Date in Natural internal format.

Field Name Format/Length
LOG-JOB-NAME (A8)

Job name corresponding to the job number contained in the record. This only applies if the job is still active at calling time.

Field Name Format/Length
LOG-JOB-NUMBER (N7)

Job number, if contained in record.

Field Name Format/Length
LOG-RECORD-TYPE (A1)

Possible values:

Value Explanation
N  Single-line message.
W  Single-line message with reply.
D  Data line of multi-line message.
E  Data/end line of multi-line message.
L  Label line of multi-line message.
M  The first line of a multi-line message.
O  Log command input.
S  Continuing previous line.
X  Entry from a source other than hardcopy or log command.
Field Name Format/Length
LOG-SOURCE (A8)

Source of the CONSOLE-LOG: SYSLOG or OPERLOG. SYSLOG is the default.

Field Name Format/Length
LOG-REPLY-ID (A8)

Reply ID of WTOR.

Field Name Format/Length
LOG-REQUEST-TYPE (A1)

Possible values :

Value Explanation
C  Command issued by operator.
R  Command response.
I  Command issued internally.
Field Name Format/Length
LOG-ROUTE-CODE (A8)

Route codes.

Field Name Format/Length
LOG-TEXT (A128)

The pure log record.

Field Name Format/Length
LOG-TIME (A8)

Time stamp in log record.

Field Name Format/Length
LOG-TIMX (T)

Time in Natural internal format.

Field Name Format/Length
NUMBER-OF-TOKENS (N3)

Number of tokens in record.

Field Name Format/Length
POSITION (B1)

Offset in log record. The RECORD field will contain log record starting at this offset.

Field Name Format/Length
RECORD (A253)

Log record.

Field Name Format/Length
RECORD-LENGTH (N3)

Length of log record.

Field Name Format/Length
RECORD-NUMBER (N9)

Retrieve records from log starting at this relative record number. If a negative value (-nnnnnnnn) is specified, the nnnnnnnn most current log records are retrieved.

Field Name Format/Length
SCAN (A3)

Specify YES to return the first record that meets the selection criteria and all the following records.

Field Name Format/Length
SCAN-COLUMN-FROM (N3)

Relevant if SCAN-TYPE=A. Specifies the column number where the scan is to start. Default is 1.

Field Name Format/Length
SCAN-COLUMN-TO (N3)

Relevant if SCAN-TYPE=A. Specifies the column number where the scan is to end. Default is the end of the record.

Field Name Format/Length
SCAN-LENGTH (N3)

Relevant if SCAN-TYPE=A. Specifies the length of the scan string in field RECORD.

Field Name Format/Length
SCAN-LIMIT (N7)

Specifies the maximum number of records to be scanned before the record is selected. If the limit is reached and no record found, error code 533 is issued.

Field Name Format/Length
SCAN-TYPE (A1)

Specify A to perform an absolute scan. The wildcard symbols asterisk (*) and underscore (_) are treated as normal characters.

Field Name Format/Length
TOKEN-VECTOR (A225)

Tokenized log record (15 tokens each with a length of 15 bytes).

Field Name Format/Length
TOKEN-DELIMITERS (A10)

Default Order of Data Returned

Messages are returned in the order in which they are found in the console hardcopy file.