| File | 1 |
|---|---|
| Statement | FIND
|
| Task | Display attributes for a given file, for example, record format, block size, record length. |
| Code | Text |
|---|---|
| 530 | Access denied by Security Facility |
| 565 | Syntax error in dataset name |
| 701 | DSNAME missing
|
| 733 | User ID does not exist |
| 772 | Requested dataset not found |
| 798 | Task was not started under TSOS. |
| 799 | Entire Systems Management Adapter internal error |
| Dictionary Field Name | Format/
Length/ Desc/Mu |
Description |
|---|---|---|
| ACCESS-NUMBER | (N4) | Shows how many times the file was accessed. |
| ACCESS-TYPE | (A5) | Shows whether the access mode is READ or WRITE. |
| ALLOCATION-TYPE | (A4) | Allocation type specified. Possible values: |
| FGG File generation group | ||
| NONE Undefined | ||
| NSTD Non-standard blocks (tape files) | ||
| PAM PAM blocks (standard) | ||
| AUDIT-TYPE | (A4) | Shows which type of access to the file must be controlled. |
| BACKUP-INFO | (A19) | Additional information about backup status: |
| D | LARG LARGE = YES | |
| MIGR MIGRATED = YES | ||
| OPEN OPEN BACKUP | ||
| PART PARTIAL RESTORE | ||
| BACKUP-TYPE | (A1) | Shows how often the file should be saved by ARCHIVE. |
| BACKUP-VERSION-NUMBER | (N5) | Internal attribute for change save with the ARCHIVE or HSMS utility routine. |
| D | ||
| BLKSIZE | (N5) | Block size in number of bytes. |
| BLOCK-CONTROL | (A6) | Block control type for this file (depending on disk type K or NK). Possible options: |
| DATA PAM key information in data (NK disks only) | ||
| NO No PAM key information (NK disks only) | ||
| NONE Block control undefined | ||
| PAMKEY Default. PAM key separate from data | ||
| CODE | (A6) | Code of tape file. |
| CREATION-DATE | (A8) | Creation date in the format DD/MM/YY. If no creation date is specified, this field is filled with asterisks ****. |
| CREATION-DATX | (D) | Creation date in Natural format. |
| DSNAME | (A54) | Required. Fully qualified file name. |
| D | ||
| DSORG | (A4) | File organization. Possible options: |
| ISAM Default. Indexed Sequential Access Method | ||
| PAM Block oriented file organization handled by | ||
| User Primary Access Method (UPAM) | ||
| PLAM Program Library Access Method (for LMS) | ||
| SAM Sequential Access Method | ||
| EXEC-PASSWORD | (A8) | If caller is TSOS and Entire Systems Management Adapter is running under TSOS, the EXEC password of the file is returned, if one exists (see field SECURITY). |
| EXPIRATION-DATE | (A8) | Expiration date in the format DD/MM/YY. If no creation date is specified, this field is filled with asterisks ****. |
| EXPIRATION-DATX | (D) | Expiration date in Natural format. |
| FILE-SEQUENCE-NUMBER | (N3) | Only for tape files: file sequence number on tape. |
| FILE-SIZE | (N10) | Field contains the number of allocated PAM pages. |
| KEY-LENGTH | (N4) | Key length for ISAM files. |
| KEY-POSITION | (N5) | Position of the first byte of the key within a record. |
| LABEL | (A7) | Type of label (tape files only). |
| LAST-REFERENCE | (A8) | Last reference date in format DD/MM/YY. If the last reference date is null, this field is filled with asterisks ****. |
| LAST-REFERENCE-DATX | (D) | Last reference date in Natural format. |
| LAST-TTR | (B3) | Last used page of the file. |
| LAST-TTTR | (B4) | Last used page of the file. |
| LRECL | (N5) | Logical record length. |
| MIGRATE | (A9) | Indicates whether the file may be migrated: ALLOWED | INHIBITED. |
| D | ||
| MODIFICATION-DATX | (D) | Date of last modification. |
| MODIFICATION-TIMX | (D) | Time of last modification. |
| NUMBER-OF-EXTENTS | (N3) | Number of extents. Values are 1 - 255. |
| NUM-OF-BACKUP-VERS | (N3) | Number of versions of a file saved in a backup archive. |
| D | ||
| PERCENT-USED | (N3) | PAM pages used / total PAM pages allocated. |
| PRODUCT | (A1) | Access method used. Possible values: |
| M LMS (only for PLAM lib) | ||
| Blank default | ||
| READ-PASSWORD | (A8) | If caller is TSOS and Entire Systems Management Adapter is running under TSOS, the READ password of the file is returned, if one exists (see field SECURITY). |
| RECFM | (A5) | Record format. |
| SECONDARY-QTY | (N10) | Secondary allocation quantity in Unit of Allocation type. |
| SECURITY | (A5) | Security status. Possible values: |
| EXEC Password-protected for execute operations. | ||
| NONE Not password-protected. | ||
| READ Password-protected for read and write operations. | ||
| WRITE Password-protected for write operations. | ||
| R/E Password-protected for read and execute operations. | ||
| R/W Password-protected for read and write operations. | ||
| R/W/E Password-protected for read, write and execute operations. | ||
| W/E Password-protected for write and execute operations. | ||
| SERIES | (A8) | Device series for the unit, for example, D3480. |
| SERIES-ARRAY | (A8) | List of series. |
| M/30 | ||
| SHARE | (A4) | Shows whether the file is accessible to other users. |
| STORAGE-LEVEL | (A2) | Indicates the storage level for migrated files: S0 | S1 | S2 | ... |
| D | ||
| VERSION-NUMBER | (N4) | Version number of the file. |
| VOLSER | (A6) | Volume serial number. Only relevant for tape files. Returns first VOLSER. For multi-volume file, see VOLSER-ARRAY. |
| VOLSER-ARRAY | (A6) | List of volumes (multi-volume file). The first VOLSER is also given in the field VOLSER. |
| M/30 | ||
| WRITE-PASSWORD | (A8) | If caller is TSOS and Entire Systems Management Adapter is running under TSOS, the WRITE password of the file is returned, if one exists (see the field SECURITY). |