CONSOLE-LOG

#### Search Results

Search

# 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.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions
- Default Order of Data Returned