CONSOLE-LOG

#### Search Results

Search

# CONSOLE-LOG

File | 25
Op-Sys | z/OS, z/VSE Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
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.

## Common Fields for all Operating Systems

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

## Additional Fields Supported for z/OS

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`DATA-SET-KEY` | N11 |  | D |
`LOG-JOB-NUMBER` | N7 |  | D |
`LOG-JOB-NAME` | A8 |  | D |
`LOG-REPLY-ID` | A8 |  | D |
`LOG-SOURCE` | A8 |  | D |

## Additional Fields Supported for z/VSE

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`DATE` | A6 |  |  |
`PARTITION` | A2 |  | D |
`MESSAGE-TYPE` | A8 |  |  |
`CONSOLE-TYPE` | A8 |  |  |
`TIME` | A8 |  |  |
`INTERNAL-RECORD-NUMBER` | N7 |  |  | The record number from the hardcopy file.

## Relevant Error Codes

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

## Field Descriptions

Field Name | Format/Length | Operating System
--- | --- | ---
`CONSOLE-TYPE` | (A8) | z/VSE

Possible type of console:

Console | Explanation
--- | ---
`HCF-ONLY` | Hard copy facility only.
`LOCAL` | Local console.
`REMOTE` | Remote console.
`REPLY` | Reply console.

Field Name | Format/Length | Operating System
--- | --- | ---
`DATE` | (A6) | z/VSE

Date the message was issued.

Field Name | Format/Length | Operating System
--- | --- | ---
`DATA-SET` | (N5) | z/OS, z/VSE

Requested dataset number of job `SYSLOG`.

Field Name | Format/Length | Operating System
--- | --- | ---
`DATA-SET-KEY` | (N1) | z/OS

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 | Operating System
--- | --- | ---
`LOG-DATX` | (D) | z/OS

Date in Natural internal format.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-JOB-NAME` | (A8) | z/OS

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 | Operating System
--- | --- | ---
`LOG-JOB-NUMBER` | (N7) | z/OS

Job number, if contained in record.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-RECORD-TYPE` | (A1) | z/OS

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 | Operating System
--- | --- | ---
`LOG-SOURCE` | (A8) | z/OS

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

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-REPLY-ID` | (A8) | z/OS

Reply ID of `WTOR`.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-REQUEST-TYPE` | (A1) | z/OS, z/VSE

Possible values for z/OS:

Value | Explanation
--- | ---
`C` | Command issued by operator.
`R` | Command response.
`I` | Command issued internally.

Under z/VSE , this field contains the message level.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-ROUTE-CODE` | (A8) | z/OS

Route codes.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-TEXT` | (A128) | z/OS

The pure log record.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-TIME` | (A8) | z/OS

Time stamp in log record.

Field Name | Format/Length | Operating System
--- | --- | ---
`LOG-TIMX` | (T) | z/OS, z/VSE

Time in Natural internal format.

Field Name | Format/Length | Operating System
--- | --- | ---
`MESSAGE-TYPE` | (A8) | z/VSE

Possible message types:

- `ACTION`

- `CONT`

- `E-ACTION`

- `DECISION`

- `INFO`

- `IPL`

Field Name | Format/Length | Operating System
--- | --- | ---
`NUMBER-OF-TOKENS` | (N3) | z/OS, z/VSE

Number of tokens in record.

Field Name | Format/Length | Operating System
--- | --- | ---
`PARTITION` | (A2) | z/VSE

Partition which issued the message.

Field Name | Format/Length | Operating System
--- | --- | ---
`POSITION` | (B1) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`RECORD` | (A253) | z/OS, z/VSE

Log record.

Field Name | Format/Length | Operating System
--- | --- | ---
`RECORD-LENGTH` | (N3) | z/OS, z/VSE

Length of log record.

Field Name | Format/Length | Operating System
--- | --- | ---
`RECORD-NUMBER` | (N9) | z/OS, z/VSE

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.

In z/VSE , `RECORD-NUMBER` may take one of two positive sets of values:

- If the value is greater than or equal to the `INTERNAL-RECORD-NUMBER` of the first record in the hardcopy file, the records returned are based on `INTERNAL-RECORD-NUMBER`.

- If the value is less, then the value is considered a logical record number and records are returned based from the beginning of the hardcopy file.

Field Name | Format/Length | Operating System
--- | --- | ---
`SCAN` | (A3) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`SCAN-COLUMN-FROM` | (N3) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`SCAN-COLUMN-TO` | (N3) | z/OS, z/VSE

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 | Operating System
--- | --- | ---
`SCAN-LENGTH` | (N3) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`SCAN-LIMIT` | (N7) | z/OS, z/VSE

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 | Operating System
--- | --- | ---
`SCAN-TYPE` | (A1) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`TIME` | (A8) | z/VSE

Time the message was issued.

Field Name | Format/Length | Operating System
--- | --- | ---
`TOKEN-VECTOR` | (A225) | z/OS, z/VSE

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

Field Name | Format/Length | Operating System
--- | --- | ---
`TOKEN-DELIMITERS` | (A10) | z/OS, z/VSE

## Default Order of Data Returned

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

### On this page

- Common Fields for all Operating Systems
- Additional Fields Supported for z/OS
- Additional Fields Supported for z/VSE
- Relevant Error Codes
- Field Descriptions
- Default Order of Data Returned