| File | 25 |
|---|---|
| Op-Sys | z/OS, z/VSE |
| 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. |
| 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.
|
| 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 |
| 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. |
| 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 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 |
Messages are returned in the order in which they are found in the console hardcopy file.