| File | 4 |
|---|---|
| Statement | FIND
|
| Task | List the VTOC of a specified disk with related information such as volume serial number, dataset name, file size, etc. |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
SYSTEM-MESSAGE-CODE
|
A10 | |||
VOLSER
|
A6 | D | Required. | |
DSNAME
|
A54 | D | ||
FILE-SIZE
|
N10 | D | ||
DSORG
|
A4 | D | ||
CREATION-DATE
|
A8 | D | ||
EXPIRATION-DATE
|
A8 | D | ||
LAST-TTR
|
B3 | D | ||
LAST-TTTR
|
B4 | D | ||
EXTENTS
|
A192 | D | ||
NUMBER-OF-EXTENTS
|
N3 | D | ||
CYLINDERS-ALLOCATED
|
N7 | D | ||
UNIT
|
A4 | D | ||
SERIES
|
A8 | D | ||
CREATION-DATX
|
D | D | ||
EXPIRATION-DATX
|
D | D | ||
EXTENT-TYPE
|
A4 | D | ||
EXTENTS-ARRAY
|
A192 | M/16 | D | |
LRECL
|
N5 | D | ||
BLKSIZE
|
N5 | D | ||
RECFM
|
A5 | D | ||
ALLOCATION-TYPE
|
A4 | D | ||
PRIMARY-QTY
|
N10 | D | ||
SECONDARY-QTY
|
N10 | D | ||
PERCENT-USED
|
N3 | D | ||
TRACKS-ALLOCATED
|
N3 | D | ||
SECURITY
|
A5 | |||
LAST-REFERENCE
|
A8 | D | ||
LAST-REFERENCE-DATX
|
D | D | ||
UPDATED-SINCE-BACKUP
|
A3 | D | ||
SMS
|
A3 | D | ||
DSNTYPE |
A8 | D |
| Code | Text |
|---|---|
| 500 | VSAM error. |
| 699 | Not enough main storage available. |
| 781 | Unable to obtain storage for work area extension. |
| 782 | Error from :1: for :2:, RC :3:, REASON :3: |
| 783 | Unable to allocate :1:, RC :2:, REASON :3: |
| 784 | Unable to open VTOC on :1:, RC :2: |
| 785 | CVAF:1: failed with RC :2: and CVSTAT :3: |
| 899 | I-O error during read. |
| 996 | Volume not online. |
| Field Name | Type/Length |
|---|---|
ALLOCATION-TYPE
|
(A4) |
Allocation type specified. Possible values:
| Value | Explanation |
|---|---|
ABS
|
Absolute |
BLK
|
Block |
CYL
|
Cylinder |
TRK
|
Track |
| Field Name | Type/Length |
|---|---|
BLKSIZE
|
(N5) |
Block size.
| Field Name | Type/Length |
|---|---|
CREATION-DATE
|
(A8) |
Dataset creation date in format
DD/MM/YY.
If no creation date is specified, the field is filled with asterisks
****.
| Field Name | Type/Length |
|---|---|
CREATION-DATX
|
(D) |
Creation date of file in Natural format.
| Field Name | Type/Length |
|---|---|
CYLINDERS-ALLOCATED
|
(N7) |
Number of integral cylinders allocated.
| Field Name | Type/Length |
|---|---|
DSNAME
|
(A54) |
Fully qualified dataset name when returned as output field. When used as input fields, this field can be used to select further datasets and supports the asterisk notation (*) as wildcard selection.
| Field Name | Type/Length |
|---|---|
DSNTYPE
|
(A8) |
Data Set Type Specification.
| Field Name | Type/Length |
|---|---|
DSORG
|
(A4) |
Dataset organization, for example PS for sequential
dataset, PO for partitioned dataset, POE for PDSE.
| Field Name | Type/Length |
|---|---|
EXPIRATION-DATE
|
(A8) |
Dataset expiration date in format
DD/MM/YY.
If no creation date is specified, the field is filled with asterisks
****.
| Field Name | Type/Length |
|---|---|
EXPIRATION-DATX
|
(D) |
Expiration date of file in Natural format.
| Field Name | Type/Length |
|---|---|
EXTENTS
|
(A192) |
Extent information. The field contains 16 entries, each 12 bytes long. Each entry contains the following:
Low cylinder and head (track) address of extent (binary
CCHH)
High cylinder and head (track) address of extent (binary
CCHH)
Number of cylinders in extent
Number of additional tracks in extent
| Field Name | Type/Length |
|---|---|
EXTENTS-ARRAY
|
(A192) M16 |
Extent information array of 16 x 16 entries, each 12 bytes long. Each entry contains the following:
Low cylinder and head (track) address of extent (binary
CCHH)
High cylinder and head (track) address of extent (binary
CCHH)
Number of cylinders in extent
Number of additional tracks in extent
| Field Name | Type/Length |
|---|---|
EXTENT-TYPE
|
(A4) |
Possible values:
| Value | Explanation |
|---|---|
FREE
|
This entry describes a free extent. |
USED
|
This entry describes a regular data set (default value). |
VTOC
|
Indicates the VTOC extent. |
| Field Name | Type/Length |
|---|---|
FILE-SIZE
|
(N10) |
Number of tracks currently allocated.
(CYLINDERS-ALLOCATED in tracks + TRACKS-ALLOCATED).
| Field Name | Type/Length |
|---|---|
| LAST-REFERENCE | (A8) |
Last reference date in format
DD/MM/YY.
If the last reference date is null, this field is filled with asterisks
****.
| Field Name | Type/Length |
|---|---|
LAST-REFERENCE-DATX
|
(D) |
Last reference date in Natural format.
| Field Name | Type/Length |
|---|---|
LAST-TTR
|
(B3) |
Last track.
| Field Name | Type/Length |
|---|---|
LAST-TTTR
|
(B4) |
Last used track and block on track (TTTR).
| Field Name | Type/Length |
|---|---|
LRECL
|
(N5) |
Logical record length.
| Field Name | Type/Length |
|---|---|
NUMBER-OF-EXTENTS
|
(A192) |
Number of extents used. Valid values are 1 - 255.
| Field Name | Type/Length |
|---|---|
PERCENT-USED
|
(N3) |
Amount of space used in the dataset as a percentage of total space.
| Field Name | Type/Length |
|---|---|
PRIMARY-QTY
|
(N10) |
Primary allocation.
| Field Name | Type/Length |
|---|---|
RECFM
|
(A5) |
Record format, for example, FB.
| Field Name | Type/Length |
|---|---|
SECONDARY-QTY
|
(N10) |
Secondary allocation.
| Field Name | Type/Length |
|---|---|
SECURITY
|
(A5) |
Security status. Possible values:
| Value | Explanation |
|---|---|
NONE
|
Not password-protected. |
READ
|
Password-protected for read and write operations. |
VSAM
|
VSAM file. |
WRITE
|
Password-protected for write operations. |
| Field Name | Type/Length |
|---|---|
SERIES
|
(A8) |
Device series for the unit, for example, 3380.
| Field Name | Type/Length |
|---|---|
SMS
|
(A3) |
Specifies whether the file is on an SMS-managed unit or device,
YES or NO.
| Field Name | Type/Length |
|---|---|
TRACKS-ALLOCATED
|
(N3) |
Number of remaining tracks allocated in addition to
CYLINDERS-ALLOCATED.
| Field Name | Type/Length |
|---|---|
UNIT
|
(A4) |
Device number of the unit on which the dataset resides.
| Field Name | Type/Length |
|---|---|
UPDATED-SINCE-BACKUP
|
(A3) |
Specifies whether the file has been updated since the last backup,
YES or NO.
| Field Name | Type/Length |
|---|---|
VOLSER
|
(A6) |
Volume serial number.
