LIB-DIRECTORY

#### Search Results

Search

# LIB-DIRECTORY

File | 3
Statement | `FIND`
Task | This view reads the directory of the specified library and returns the entries record by record.

## Fields

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 |  |  |
`DSNAME` | A54 |  | D | Required.
`PASSWORD` | A8 |  | D |
`ALIAS` | A8 |  | D |
`ALIAS-ORIGINAL` | A8 |  | D |
`GENERATION` | N9 |  | D |
`LONG-ALIAS` | A3 |  | D |
`MEMBER` | A10 |  | D |
`MEMBER-LONG-NAME` | A253 |  | D | Valid only if `LONG-ALIAS = 'YES'` requested.
`MEMBER-TTR` | B4 |  | D |
`MODULE-ATTRIBUTES` | A80 |  | D |
`MODULE-LENGTH` | N11 |  | D |
`NUMBER-OF-OCCURRENCES` | N7 |  | D |
`OPTIONS` | A80 |  | D |
`PRODUCT` | A1 |  | D |
`RECORD` | A200 |  | D |
`USER-DATA` | A120 |  | D |
`USER-DATA-HEX` | B120 |  | D |
`USER-DATA-LENGTH` | N3 |  | D |
`VERSION` | A2 |  | D |
`VOLSER` | A6 |  | D | Required only if dataset is not cataloged.

## Relevant Error Codes

Code | Text
--- | ---
500 | VSAM error
550 | File not a PDS
699 | GETVIS failed
899 | I/O error during read
906 | `DESERV` error, R15=xxxxxxxx, R0=xxxxxxxx
991 | Unknown product
993 | `OPEN` error

## Field Descriptions

Field Name | Type/Length
--- | ---
`ALIAS` | (A8)

Possible values:

Value | Explanation
--- | ---
`YES` | Member name is an alias name.
`NO` | Member name is an original name.

Field Name | Type/Length
--- | ---
`ALIAS-ORIGINAL` | (A8)

If `ALIAS=YES`, original name of the member (load libraries only).

Field Name | Type/Length
--- | ---
`DSNAME` | (A54)

Fully qualified dataset name.

Field Name | Type/Length
--- | ---
`GENERATION` | (N9)

Generation number of member (only valid for PDSE version 2).

Field Name | Type/Length
--- | ---
`LONG-ALIAS` | (A3)

If set to `YES`, will return member alias names longer than 8 bytes in length (see `MEMBER-LONG-NAME`). Default is `NO`.

Field Name | Type/Length
--- | ---
`MEMBER` | (A10)

Name of member.

Field Name | Type/Length
--- | ---
`MEMBER-LONG-NAME` | (A253)

If `LONG-ALIAS` is set to `YES`, then this field will contain the first 253 bytes of member names, including those members whose name length is less than or equal to 8. If `LONG-ALIAS` is set to `NO`, then this field is equivalent to `MEMBER`.

Field Name | Type/Length
--- | ---
`MEMBER-TTR` | (B4)

Field Name | Type/Length
--- | ---
`MODULE-ATTRIBUTES` | (A253)

The module's attributes in keyword format. The relevant keywords are separated by one blank. Possible values:

`1PAGE` | First segment is page aligned.
`2PAGE` | Second segment is page aligned.
`1RMODE31` | First segment is `RMODE 31`.
`2RMODE31` | Second segment is `RMODE 31`.
`AMODE24` | Phase has `AMODE 24`.
`AMODE31` | Module/alias is `AMODE 31`.
`AMODE64` | Module/alias is `AMODE 64`.
`AMODEANY` | Module/alias is `AMODE ANY`.
`AUTH` | APF-authorized.
`COMPRESSED` | Module is in `COMPRESSED` format.
`FETCHPACK` | Module is `FETCHOPT PACK`.
`FETCHPRIME` | Module is `FETCHOPT PRIME`.
`FILLx` | `FILL` option is set. The character following `FILL` is the value. Note It may not be printable (a `MOVE EDITED` would be needed to convert the value to hexadecimal).
`LOADONLY` | Only loadable.
`MAMODE31` | If alias, main EP is `AMODE 31`.
`MAMODE64` | If alias, main EP is `AMODE 64`.
`MAMODEANY` | If alias, main EP is `AMODE ANY`.
`NOTEXEC` | Not executable.
`OVLY` | Overlay.
`PAGE` | Module is page aligned.
`REFR` | Refreshable.
`RENT` | Reentrant.
`REUS` | Reusable.
`RMODE24` | Phase has `RMODE 24`.
`RMODE31` | Phase has `RMODE 31`.
`RMODEANY` | Module is `RMODE ANY`.
`SCTR` | Scatter.
`SSI` | Module has SSI data.
`TEST` | Test option (TSO).
`AMODEANY` | Phase has `AMODE ANY`.
`AMODE24` | Phase has `AMODE 24`.
`AMODE31` | Phase has `AMODE 31`.
`MSHPBYP` | Member is MSHP bypassed.
`MSHPCTL` | Member is MSHP controlled.
`RECTYPEF` | Member has fixed record format.
`RECTYPEU` | Member has undefined record format.
`RECTYPEV` | Member has variable record format.
`RMODEANY` | Phase has `RMODE ANY`.
`RMODE24` | Phase has `RMODE 24`.
`RMODE31` | Phase has `RMODE 31`.
`SYSIPT` | Member contains `SYSIPT` data.

Field Name | Type/Length
--- | ---
`MODULE-LENGTH` | (N11)

Length of module in bytes.

Field Name | Type/Length
--- | ---
`NUMBER-OF-OCCURRENCES` | (N7)

Number of records which contain the requested string.

Field Name | Type/Length
--- | ---
`OPTIONS` | (A80)

Option | Explanation
--- | ---
`ARC` | Get list of archived members (CA-Librarian access method).

Field Name | Type/Length
--- | ---
`PASSWORD` | (A8)

Password for protected datasets.

Field Name | Type/Length
--- | ---
`PRODUCT` | (A1)

Access method used. Possible options:

Option | Explanation
--- | ---
`L` | CA-Librarian
`P` | CA-Panvalet

Field Name | Type/Length
--- | ---
`RECORD` | (A200)

String for which `SCAN` is to be performed.

Field Name | Type/Length
--- | ---
`USER-DATA` | (A120)

User data for the member.

ISPF statistics entry (if any). For further information, refer to ISPF statistics entry in a PDS directory under ISPF Messages and Codes Manual > Diagnostic Tools and Information > Diagnostic information in the z/OS ISPF BookShelf.

Field Name | Type/Length
--- | ---
`USER-DATA-HEX` | (B120)

User data for the member in hexadecimal format.

Field Name | Type/Length
--- | ---
`USER-DATA-LENGTH` | (N3)

Length of user data for the member.

Field Name | Type/Length
--- | ---
`VERSION` | (A2)

Version of CA-Panvalet access method.

Field Name | Type/Length
--- | ---
`VOLSER` | (A6)

Volume serial number.

## Default Order of Data Returned

Members are presented in ascending order.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions
- Default Order of Data Returned