| File | 12 |
|---|---|
| Op-Sys | z/OS, z/VSE |
| Statement | FIND
|
| Task | Read SYSOUT from spool. This view retrieves records from
JES (z/OS) or POWER (z/VSE ). Use the SPOOL-FILES view to retrieve
a list of spool files relating to the specified job before executing
READ-SPOOL.
|
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
JOB-NAME
|
A8 | D | Required if JOB-NUMBER is blank.
|
|
JOB-NUMBER
|
N7 | D | Required if JOB-NAME is blank
|
|
JOB-ID
|
A8 | D | Required if JOB-NAME and
JOB-NUMBER are blank.
|
|
RECORD-NUMBER
|
N7 | D | ||
TYPE
|
A2 | D | Required. | |
RECORD-LENGTH
|
N5 | D | ||
RECORD
|
A253 | D | ||
POSITION
|
B1 | D | ||
DATA-SET-KEY
|
N11 | D | ||
SCAN
|
A3 | D | ||
SCAN-LIMIT
|
N7 | D | ||
SCAN-TYPE
|
A1 | D | ||
SCAN-LENGTH
|
N3 | D | Only relevant if SCAN-TYPE=A.
|
|
SCAN-COLUMN-FROM
|
N3 | D | Only relevant if SCAN-TYPE=A.
|
|
SCAN-COLUMN-TO
|
N3 | D | Only relevant if SCAN-TYPE=A.
|
|
TIME-LIMIT
|
N5 | D |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
DATA-SET
|
N5 | D | ||
SEGMENT-NUMBER
|
N3 | D | ||
SEGMENT-LENGTH
|
N3 | D |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
CONTROL-RECORDS
|
A3 | D | ||
RECORD-TYPE
|
B1 | D | This field is only relevant if
CONTROL-RECORDS=YES.
|
|
INTERNAL-RECORD-NUMBER
|
N7 | D | ||
SEGMENT-NUMBER
|
N3 | D |
| Code | Text | z/OS | z/VSE |
|---|---|---|---|
| 533 | Requested number of records scanned. | X | X |
| 537 | Time limit reached. | X | X |
| 680 | Job/Output is protected. | X | |
| 681 | Job/Output is active. | X | |
| 682 | Job/Output not dispatchable. | X | |
| 699 | GETVIS storage request has failed. | X | |
| 711 | Logical Error occurred in Common JES Interface. | X | |
| 712 | Request to Common JES Interface failed. | X | |
| 713 | Jobname and Job ID missing. One of them required. | X | |
| 715 | Duplicate jobnames found. Please specify job ID. | X | |
| 719 | Unable to :1: SYSOUT dataset. | X | |
| 720 | Invalid type. Must be CC/RD/LS/PU/XM. | X | |
| 722 | Requested dataset not found. | X | |
| 723 | Requested job in input queue. | X | |
| 724 | Requested job not found. | X | X |
| 728 | You are not allowed to see this job. | X | |
| 731 | Error occurred during spool get. | X | |
| 781 | Unable to obtain storage for work area extension. | X | |
| 830 | JES interface is not active. | X | |
| 830 | POWER interface is not active. | X |
| Field Name | Type/Length | Operating System |
|---|---|---|
CONTROL-RECORDS
|
(A3) | z/VSE |
Specifies whether control records are to be returned. Possible options:
| Option | Explanation |
|---|---|
NO
|
Control records are not returned. |
YES
|
Default. Control records are returned. |
| Field Name | Type/Length | Operating System |
|---|---|---|
DATA-SET
|
(N5) | z/OS |
Requested dataset number (see also the DATA-SET-KEY
field).
| Field Name | Type/Length | Operating System |
|---|---|---|
DATA-SET-KEY
|
(N11) | z/OS, z/VSE |
Unique dataset identification. This offers much faster access than
the dataset number. The dataset key can be obtained using the
SPOOL-FILES view.
| Field Name | Type/Length | Operating System |
|---|---|---|
INTERNAL-RECORD-NUMBER
|
(N7) | z/VSE |
Internal record number as returned by POWER.
| Field Name | Type/Length | Operating System |
|---|---|---|
JOB-NAME
|
(A8) | z/OS, z/VSE |
Name of job. If you do not specify a job name, you must specify the
JOB-NUMBER field.
| Field Name | Type/Length | Operating System |
|---|---|---|
JOB-ID
|
(A8) | z/OS, z/VSE |
Job number in alphanumeric format.
| Field Name | Type/Length | Operating System |
|---|---|---|
JOB-NUMBER
|
(N7) | z/OS, z/VSE |
Job number assigned by the spooling system. If you do not specify a
job number, you must specify the JOB-NAME field.
| Field Name | Type/Length | Operating System |
|---|---|---|
| POSITION | (B1) | z/OS, z/VSE |
Offset in spool record (the RECORD field contains
spool record starting at this offset).
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD
|
(A253) | z/OS, z/VSE |
Spool record to be searched (see also the POSITION
field).
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD-LENGTH
|
(N5) | z/OS, z/VSE |
Length of entire spool record (not the segment length).
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD-NUMBER
|
(N7) | z/OS, z/VSE |
Relative record number from start of dataset.
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD-TYPE
|
(B1) | z/VSE |
Record type of spool record. This field is relevant if
CONTROL-RECORDS=YES. This field contains the type of record
returned. Possible values:
| Option | Explanation |
|---|---|
X'00'
|
Normal data record. |
X'05'
|
Control command record. |
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN
|
(A3) | z/OS, z/VSE |
If you specify YES, the first record which meets the
selection criteria and all subsequent records are returned.
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN-COLUMN-FROM
|
(N3) | z/OS, z/VSE |
Specifies the column number where the scan is to start. Default is column 1.
Note:
Only relevant if SCAN-TYPE=A.
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN-COLUMN-TO
|
(N3) | z/OS, z/VSE |
Specifies the column number where the scan is to end. Default is
the end of the record. Only relevant if SCAN-TYPE=A.
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN-LENGTH
|
(N3) | z/OS, z/VSE |
Specifies how much of the string in the RECORD field
is to be scanned. Only relevant if SCAN-TYPE=A.
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN-LIMIT
|
(N7) | z/OS, z/VSE |
Maximum number of records to be scanned before a record is found
that matches the search criteria. If this limit is reached and no matching
record is found, ERROR-CODE 533 with the appropriate
text is returned.
| Field Name | Type/Length | Operating System |
|---|---|---|
SCAN-TYPE
|
(A1) | z/OS, z/VSE |
Specify A for an absolute search. Note that wildcard
symbols (* and _) are then treated as normal characters.
| Field Name | Type/Length | Operating System |
|---|---|---|
SEGMENT-LENGTH
|
(N3) | z/OS |
Length of segment of spool record. If this field is not specified
or zero, only the first segment will be returned, even if the spool record is
longer than the RECORD area.
| Field Name | Type/Length | Operating System |
|---|---|---|
SEGMENT-NUMBER
|
(N3) | z/OS, z/VSE |
Segment number of spool record to be retrieved, if the output is segmented.
z/OS: Segment number within record.
z/VSE: Segment number of spool record to be retrieved, if the output is segmented.
| Field Name | Type/Length | Operating System |
|---|---|---|
TIME-LIMIT
|
(N5) | z/OS, z/VSE |
Specifies the maximum number of seconds that a record can be
scanned. If this limit is exceeded and no match is found,
ERROR-CODE 537 is returned.
| Field Name | Type/Length | Operating System |
|---|---|---|
TYPE
|
(A2) | z/OS, z/VSE |
Spool dataset type. Possible values:
| z/OS | |
|---|---|
AL
|
Read all SM/SO files as one file. |
CC
|
Summary of job steps and completion codes. |
JL
|
Input JCL. |
SI
|
SYSIN data.
|
SM
|
System messages. |
SO
|
SYSOUT data.
|
| z/VSE | |
|---|---|
CC
|
Summary of job steps and completion codes. |
LS
|
List queue. |
PU
|
Punch queue. |
RD
|
Reader queue. |
XM
|
Transmit queue. |
Records are returned in order from the start of the
SYSOUT data set.