| File | 1 |
|---|---|
| Statement | FIND
|
| Task | Display attributes for a given file, for example, record format, block size, record length. |
| 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 | ||
DSNAME
|
A54 | D | Required. | |
DSORG
|
A4 | |||
CREATION-DATE
|
A8 | |||
EXPIRATION-DATE
|
A8 | |||
LAST-TTR
|
B3 | |||
LAST-TTTR
|
B4 | |||
FILE-SIZE
|
N10 | |||
SECURITY
|
A5 | |||
SERIES
|
A8 | |||
CREATION-DATX
|
D | |||
EXPIRATION-DATX
|
D | |||
PRODUCT
|
A1 | |||
LRECL
|
N5 | |||
BLKSIZE
|
N5 | |||
RECFM
|
A5 | |||
PAGES-USED
|
N10 | PDSE only: Number of used pages. | ||
PASSWORD
|
A8 | D | ||
EXTENTS
|
A192 | |||
EXTENTS-ARRAY
|
A192 | 59 | ||
CYLINDERS-ALLOCATED
|
N7 | |||
TRACKS-ALLOCATED
|
N3 | |||
UNIT
|
A3 | |||
NUMBER-OF-EXTENTS
|
N3 | |||
ALLOCATION-TYPE
|
A3 | |||
SECONDARY-QTY
|
N10 | Secondary allocation quantity in Unit of Allocation type. | ||
PRIMARY-QTY
|
N10 | Primary allocation quantity in Unit of Allocation type. | ||
PERCENT-USED
|
N3 | |||
LAST-REFERENCE
|
A8 | |||
LAST-REFERENCE-DATX
|
D | |||
NUMBER-OF-MEMBERS
|
N7 | |||
TOTAL-DIRECTORY-BLOCKS
|
N5 | |||
UNUSED-DIRECTORY-BLOCKS
|
N5 | |||
UPDATED-SINCE-BACKUP
|
A3 | |||
SMS
|
A3 | |||
OPTIONS
|
A80 | |||
SMS-STORAGE-CLASS
|
A8 | |||
SMS-MANAGEMENT-CLASS
|
A8 | |||
SMS-DATA-CLASS
|
A8 | |||
CREATE-JOBNAME |
A8 | |||
CREATE-STEPNAME |
A8 | |||
DSNTYPE |
A8 | |||
DSNTYPE-VERSION |
N1 | |||
EATTR |
A3 | |||
VOLSER-ARRAY
|
A6 | 59 | For multi-volume datasets on DASD | |
SERIES-ARRAY
|
A8 | 59 | For multi-volume datasets on DASD | |
EXTENTS-ARRAY
|
A192 | 59 | For multi-volume datasets on DASD | |
MAXGENS |
N9 | |||
SHORT-INFO |
A4 |
| Code | Text |
|---|---|
| 500 | VSAM error |
| 506 | Data set is migrated. |
| 699 | GETVIS failed |
| 701 |
DSNAME missing
|
| 786 | Unable to obtain storage for CSI work area. |
| 787 | CSI request failed, Module :1:, Reason :2:, RC :3:. |
| 899 | I/O error during read |
| 993 | Open error |
| Field Name | Type/Length |
|---|---|
ALLOCATION-TYPE
|
(A4) |
Allocation type specified. Possible values:
ABS |
Absolute |
BLK |
Block |
CYL |
Cylinders |
TRK |
Track |
| Field Name | Type/Length |
|---|---|
BLKSIZE
|
(N5) |
Block size.
| Field Name | Type/Length |
|---|---|
CREATE-JOBNAME
|
(A8) |
Job name used to create the data set described by its format 8 DSCB.
| Field Name | Type/Length |
|---|---|
CREATE-STEPNAME
|
(A8) |
Step name used to create the data set described by its format 8 DSCB.
| Field Name | Type/Length |
|---|---|
CREATION-DATE
|
(A8) |
Creation date in the format
DD/MM/YY.
If no creation date is specified, this field is filled with asterisks
****.
| Field Name | Type/Length |
|---|---|
CREATION-DATX
|
(D) |
Creation date 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.
| Field Name | Type/Length |
|---|---|
DSNTYPE
|
(A8) |
Data Set Type Specification.
| Field Name | Type/Length |
|---|---|
DSNTYPE-VERSION
|
(N1) |
The data set version number for a library (PDSE). Possible values are 1 or 2.
| Field Name | Type/Length |
|---|---|
DSORG
|
(A4) |
Dataset organization.
For example: PS, PO, VS.
| Field Name | Type/Length |
|---|---|
EATTR
|
(A3) |
Extended attributes. Possible values:
| Value | Explanation |
|---|---|
OPT
|
Data set can support extended attributes (format 8 and 9 DSCBs). |
NO |
Data set does not support extended attributes. (default). |
| Field Name | Type/Length |
|---|---|
EXPIRATION-DATE
|
(A8) |
Expiration date in the format DD/MM/YY. If no creation date is specified, this field is filled with asterisks ****.
| Field Name | Type/Length |
|---|---|
EXPIRATION-DATX
|
(D) |
Expiration date in Natural format.
| Field Name | Type/Length |
|---|---|
EXTENTS
|
(A192) |
Extent information, 16 entries of 12 bytes each. Each entry contains:
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) 59 |
Array of extents for multi-volume datasets. Each element reflects one volume.
| 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 |
|---|---|
MAXGENS
|
(N9) |
Maximum number of member generations for a PDSE version 2.
Possible values are 0 (no generations) or a value between 1 and the upper limit specified as MAXGENS_LIMIT in parmlib member IGDSMSxx.
| Field Name | Type/Length |
|---|---|
NUMBER-OF-EXTENTS
|
(N3) |
Number of extents.
Values are 1 - 16
| Field Name | Type/Length |
|---|---|
NUMBER-OF-MEMBERS
|
(N7) |
Number of members in the dataset. If the dataset is not a
partitioned dataset, this field shows 0.
| Field Name | Type/Length |
|---|---|
OPTIONS
|
(A80) |
Options for CA-Panvalet, CA-Librarian, etc.
| Field Name | Type/Length |
|---|---|
PAGES-USED
|
(N10) |
The number of pages allocated for members and directory information in a PDSE.
| Field Name | Type/Length |
|---|---|
PASSWORD
|
(A8) |
Specify password for protected datasets.
| Field Name | Type/Length |
|---|---|
PERCENT-USED
|
(N3) |
Tracks used / tracks allocated.
| Field Name | Type/Length |
|---|---|
PRIMARY-QTY
|
(A10) |
Primary allocation quantity in unit of allocation type.
| Field Name | Type/Length |
|---|---|
PRODUCT
|
(A1) |
Access method used. Possible values:
| Value | Explanation |
|---|---|
L
|
CA-Librarian |
P
|
CA-Panvalet |
| Field Name | Type/Length |
|---|---|
RECFM
|
(A5) |
Record format.
| Field Name | Type/Length |
|---|---|
SECONDARY-QTY
|
(N10) |
Secondary allocation quantity in Unit of Allocation type.
| Field Name | Type/Length |
|---|---|
SECURITY
|
(A5) |
Security status. Possible values:
| Value | Explanation |
|---|---|
NONE
|
Not password-protected. |
READ
|
Password-protected for read and write operations. |
WRITE
|
Password-protected for write operations. |
| Field Name | Type/Length |
|---|---|
SHORT-INFO
|
(A4) |
This enables calling file attributes also for PDS data sets without RACF read access for which some users might not have permission.
| Value | Explanation |
|---|---|
YES
|
The following values are not be returned for PO / POE data sets: TOTAL-DIRECTORY-BLOCKS UNUSED-DIRECTORY-BLOCKS NUMBER-OF-MEMBERS DSNTYPE-VERSION MAXGENS TOTGENS PERCENT-USED for HFS data sets: PERCENT-USED. |
NO
|
Default. |
