| File | 34 |
|---|---|
| Op-Sys | z/OS |
| Statement | FIND
|
| Task | Read from SMF records. |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
ACTIVE
|
A3 | D | Relevant with FILE-ID='LIST'.
|
|
DATE
|
N5 | D | ||
DATX
|
D | D | ||
DIRECTION
|
A1 | D | ||
DSNAME
|
A44 | D | Required unless FILE-ID='LIST'.
|
|
FILE-ID
|
A8 | D | Required. | |
JOB-NAME
|
A8 | D | ||
RBA
|
N9 | D | ||
RECORD-LENGTH
|
N5 | D | ||
RECORD-TYPE
|
N3 | D | Required. | |
RECORD
|
A253 | D | ||
SEGMENT-LENGTH
|
B2 | D | ||
SEGMENT-NUMBER
|
N5 | D | ||
START-RBA
|
N9 | D | ||
SUB-TYPE
|
N3 | D | ||
SYSTEM-ID
|
A4 | D | ||
TIME
|
N6 | D | ||
TIMX
|
T | D | ||
TOTAL-BLOCKS
|
N7 | D | Relevant with FILE-ID='LIST'.
|
|
USED-BLOCKS
|
N7 | D | Relevant with FILE-ID='LIST'.
|
|
VOLSER
|
A6 | D | Relevant with FILE-ID='LIST'.
|
| Code | Text | z/OS |
|---|---|---|
|
640 |
Error generating VSAM control blocks. | X |
|
641 |
Error :1: while opening SMF or VSAM file. | X |
|
642 |
Error :1: while reading SMF or VSAM file. | X |
|
643 |
SMF not active / not recording. | X |
|
644 |
Invalid file ID. | X |
|
645 |
Invalid RBA was specified. | X |
| 650 | Invalid sequential file. | X |
| 701 | DSNAME missing.
|
X |
| 781 | Unable to obtain storage for work area extension. | X |
| 902 | Dynamic allocation failed. | X |
|
990 |
Field record not found in format buffer. | X |
| 993 | Cannot open file. | X |
| Field Name | Type/Length | Operating System |
|---|---|---|
ACTIVE
|
(A3) |
Relevant for FILE-ID='LIST'. Possible options:
| Option | Explanation |
|---|---|
NO
|
This is not the active SMF file. |
YES
|
This is the active SMF file. |
The individual types, lengths and operating systems for the fields are as follows:
| Field Name | Type/Length | Operating System |
|---|---|---|
DATE
|
(N5) |
The date of the record in the format
YYDDDD, taken from the SMF record
prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
DATX
|
(D) |
The date in internal format, taken from the SMF record prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
DIRECTION
|
(A1) |
Retrieval direction. Possible values:
| Value | Explanation |
|---|---|
F
|
Read forward (default). |
B
|
Read backwards. |
The individual types, lengths and operating systems for the fields are as follows:
| Field Name | Type/Length | Operating System |
|---|---|---|
DSNAME
|
(A44) |
For FILE-ID='LIST', the names of the SMF data sets
are returned in this field.
For FILE-ID='MANX', specify the name of the SMF
data set from which the SMF records are to be read.
For FILE-ID='LOGS', specify the name of the SMF log
stream from which the SMF records are to be read.
For FILE-ID='SEQ', specify the name of the
sequential data set from which the SMF records are to be read.
| Field Name | Type/Length | Operating System |
|---|---|---|
FILE-ID
|
(A8) |
Possible values:
| Value | Explanation |
|---|---|
LIST
|
Return a list of SMF data sets and other relevant data. |
MANX
|
Read records from the SMF data set specified in
DSNAME.
|
LOGS
|
Read records from the SMF log stream specified in
DSNAME.
|
SEQ
|
Read dumped SMF records from the sequential data set
specified in DSNAME.
|
The individual types, lengths and operating systems for the fields are as follows:
| Field Name | Type/Length | Operating System |
|---|---|---|
JOB-NAME
|
(A8) |
This field follows the SMF record prefix. For most record types, it contains the job name.
| Field Name | Type/Length | Operating System |
|---|---|---|
RBA
|
(N9) |
Relative byte address of the record.
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD
|
(A253) |
The SMF record / segment.
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD-LENGTH
|
(N5) |
Length of the entire record (not the segment length).
| Field Name | Type/Length | Operating System |
|---|---|---|
RECORD-TYPE
|
(N3) |
The type of the record, taken from the SMF record prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
SEGMENT-NUMBER
|
(N5) |
Segment number within the record.
| Field Name | Type/Length | Operating System |
|---|---|---|
SEGMENT-LENGTH
|
(B2) |
Length of the segment.
| Field Name | Type/Length | Operating System |
|---|---|---|
START-RBA
|
(N9) |
The relative byte address of the first record to be read. If
omitted, the file is read from the start or end, depending on the setting of
DIRECTION.
| Field Name | Type/Length | Operating System |
|---|---|---|
SUB-TYPE
|
(N3) |
SMF subtype.
| Field Name | Type/Length | Operating System |
|---|---|---|
SYSTEM-ID
|
(A4) |
System ID, taken from the SMF record prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
TIME
|
(N6) |
The time of the record in the format
HH:MM:SS,
taken from the SMF record prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
TIMX
|
(T) |
The time of the record in the format
YYDDDD, taken from the SMF record
prefix.
| Field Name | Type/Length | Operating System |
|---|---|---|
TOTAL-BLOCKS
|
(N7) |
Relevant when FILE-ID='LIST'. Number of blocks
allocated to the SMF file.
| Field Name | Type/Length | Operating System |
|---|---|---|
USED-BLOCKS
|
(N7) |
Relevant when FILE-ID='LIST'. Number of blocks used in
the SMF file.
| Field Name | Type/Length | Operating System |
|---|---|---|
VOLSER
|
(A6) |
Relevant when FILE-ID='LIST'. Volume serial number of
the SMF file.