| File | 8 |
|---|---|
| Statement | FIND
|
| Task | This view displays the catalog information
of a specified file.
The information retrieved is the same as returned by the
system command |
| Code | Text |
|---|---|
| 530 | Access denied by Security Facility. |
| 565 | Syntax error in dataset name. |
| 604 | No volumes specified. |
| 699 | Not enough main storage available. |
| 701 | DSNAME missing.
|
| 722 | Requested dataset not found. |
| 733 | User ID does not exist. |
| 750 | Invalid operand within operand list. |
| 798 | Task was not started under TSOS. |
| 799 | Entire Systems Management Adapter internal error. |
| 996 | Volume not online. |
| Dictionary Field Name | Format/
Length/ Desc/Mu |
Description |
|---|---|---|
| ACCESS-TYPE | (A5) | List all files accessible by READ or WRITE. Possible options: |
| D | R or READ | |
| W or WRITE | ||
| BACKUP-TYPE | (A11) | Search criteria only, this field is returned unchanged. Files of the specified type(s) are listed. Possible types: A, B, C, D, E. Multiple types must be given as: A,B,C. |
| D | ||
| BLOCK-CONTROL-OPTION | (A21) | Search criteria only, this field is returned unchanged. Retrieves files with specified control type. Possible values: |
| D | DATA | |
| NO | ||
| NONE | ||
| PAMKEY | ||
| Multiple values must be separated by commas and enclosed in brackets, for example: (PAMKEY,DATA). | ||
| CREATION-RANGE | (A19) | Define ranges for catalog entries. |
| D | List files with a creation date as follows: | |
| (,YY-MM-DD) Files created before the specified date. | ||
| (YY-MM-DD,) Files created since the specified date. | ||
| YY-MM-DD Files created on the specified date. | ||
| (YY-MM-DD,YY-MM-DD) | ||
| Files created between the specified dates. | ||
| DSNAME | (A54) | This field specifies the file name. |
| D | An asterisk ‘*’can be used as wildcard as in the /FSTAT command. | |
| EXPIRATION-RANGE | (A19) | Define ranges for catalog entries. |
| D | List files with an expiration date as follows: | |
| (,YY-MM-DD) Files expired before specified date. | ||
| (YY-MM-DD,) Files expired since specified date. | ||
| YY-MM-DD Files expired on the specified date. | ||
| (YY-MM-DD,YY-MM-DD) | ||
| Files expired between the specified dates. | ||
| EXTENT-RANGE | (A13) | Define ranges for catalog entries. |
| D | List files with number of extents within a given range. | |
| (,n) Files with fewer extents than specified number. | ||
| (n,) Files with more extents than specified number. | ||
| (n,m) Files with extents between specified numbers. | ||
| n Files with n extents. | ||
| FCBTYPE | (A11) | Search criteria only, this field is returned unchanged. List all files with specified type(s). Possible options: |
| D | B or BTAM | |
| I or ISAM | ||
| N or NONE | ||
| P or PAM | ||
| S or SAM | ||
| Specification of multiple types is possible, for example, (P,I). | ||
| FILE-SIZE | (N10) | Number of PAM pages allocated by a file. |
| FREE-SIZE-RANGE | (A19) | Define ranges for catalog entries. List files with a number of free PAM pages expressed as follows: |
| D | (,n) Files with fewer free pages than specified | |
| number. | ||
| (n,) Files with more free pages than specified number. | ||
| (n,m) Files with free pages between specified numbers. | ||
| n Files with n free pages. | ||
| GEN | (A3) | Specify YES to list the files of a generation group. |
| D | ||
| LAST-ACCESS-RANGE | (A19) | Define ranges for catalog entries. List files with last access date within a time range given as follows: |
| D | (,YY-MM-DD) Files accessed before specified date. | |
| (YY-MM-DD,) Files accessed since specified date. | ||
| YY-MM-DD Files accessed on the specified date. | ||
| (YY-MM-DD,YY-MM-DD) Files accessed between the specified dates. | ||
| PASSWORD-OPTION | (A9) | List the files with password options expressed as follows: |
| D | E or EXPASS | |
| N or NONE | ||
| R or RDPASS | ||
| W or WRPASS | ||
| Multiple options can be specified, for example: (R,N). | ||
| SHARE | (A3) | Possible options: |
| D | NO List non-shareable files. | |
| YES List shareable files. | ||
| SIZE-RANGE | (A19) | Define ranges for catalog entries. List files with size within a given range. Size means number of PAM pages: |
| D | (,n) Files smaller than specified number. | |
| (n,) Files larger than specified number. | ||
| (n,m) Files with size between specified numbers. | ||
| N Files of size n. | ||
| STATE | (A6) | Search criteria only, this field is returned unchanged. Specifies state of file. Possible options: |
| D | blank List all files. | |
| NOCLOS List all open files. | ||
| SUPPORT-TYPE | (A9) | Active search criteria. List all files that are on public or private disks or on tapes. Possible options: |
| D | PRV Private. | |
| PUB Public. | ||
| TAP Tapes. | ||
| These values can also be combined, for example: (PUB,PRV) for public and private. | ||
| The following values are returned: PUBLIC, PRDISC, MIGRAT or TAPE. MIGRAT indicates migrated files. | ||
| TYPE | (A8) | Active search criteria. Possible values: |
| D | FGG File generation group. | |
| blank All other files | ||
| VOLSER | (A6) | Search criteria only. Volume serial number of file. |
| D |