LIB-DIRECTORY

File 3
Op-Sys z/OS, z/VSE, BS2000/OSD
Statement FIND
Task This view reads the directory of the specified library and returns the entries record by record.

Common Fields for all Operating Systems

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 in z/OS and BS2000/OSD.
PASSWORD A8   D  

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
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.

Additional Fields Supported for z/VSE

Dictionary Field Name F/L Mu DE Remarks
BLOCK-COUNT N5   D Number of blocks used by the member or sub-library.
DATE-CHANGED A6   D  
DATE-CREATED A6   D Creation date of member or sub-library in format YYMMDD.
DATX-CHANGED D   D  
DATX-CREATED D   D Creation date of member or sub-library in internal format.
LIBRARY A8   D Required.
LIBRARY-BLOCKS-USED N7   D Relevant if LIST-SUBLIBS=YES.
LIST-SUBLIBS A3   D Not required if SUB-LIBRARY is specified.
MEMBER A10   D  
MEMBER-COUNT N5   D Relevant if LIST-SUBLIBS=YES.
MEMBER-TYPE A8   D  
MODULE-ATTRIBUTES A80   D  
RECORD-COUNT N7   D  
SUB-LIBRARY A8   D Not required if LIST-SUBLIBS is specified.
TIME-CHANGED N7      
TIME-CREATED N7     Creation time of member (a numeric value equivalent to HHMMSS).
USER-DATA A120   D  
USER-DATA-HEX (B120)   D  
USER-DATA-LENGTH N3   D  
VOLSER A6   D Required only if dataset is not known to Entire System Server.
VSAM-CATALOG A8   D Required only if VSAM-controlled CA-Librarian file.

Additional Fields Supported for BS2000/OSD

Dictionary Field Name F/L Mu DE Remarks
CREATION-DATE A14   D  
CREATION-TIME A8   D  
ELEMENT A64   D  
ELEMENT-TYPE A8   D  
ELEMENT-VERSION A24   D  
EXEC-PROTECTION A5      
MODIF-DATE A14   D  
MODIF-TIME A8   D  
PRODUCT A1   D  
READ-PROTECTION A5      
STORE-FORM A1   D  
SYSTEM-CODE B2      
USER-DATE A14   D  
USER-DATX D   D  
USER-TIME A8   D  
USER-TIMX T   D  
WRITE-PROTECTION A5      

Relevant Error Codes

Code Text z/OS z/VSE BS2000/OSD
500 VSAM error X    
530 Access denied by Security Facility     X
531 Password missing or incorrect     X
550 File not a PDS X    
565 Syntax error in dataset name     X
697 Library/Sublib not found   X  
698 Internal CA-Librarian error   X  
699 GETVIS failed X X  
701 DSNAME missing     X
733 User ID does not exist     X
772 Requested dataset not found     X
798 Task was not started under TSOS.     X
799 Entire System Server internal error     X
878 Volume defined as CA-Dynam/D pool name.   X  
899 I/O error during read X    
906 DESERV error, R15=xxxxxxxx, R0=xxxxxxxx X    
991 Unknown product X   X
993 OPEN error X    

Field Descriptions

Field Name Type/Length Operating System
ALIAS (A8) z/OS

Possible values:

Value Explanation
YES Member name is an alias name.
NO Member name is an original name.
Field Name Type/Length Operating System
ALIAS-ORIGINAL (A8) z/OS

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

Field Name Type/Length Operating System
BLOCK-COUNT (N5) z/VSE

Number of blocks used by the member.

Field Name Type/Length Operating System
CREATION-DATE (A14) BS2000/OSD

Creation date of element.

Field Name Type/Length Operating System
CREATION-TIME (A8) BS2000/OSD

Creation time of element.

Field Name Type/Length Operating System
DATE-CHANGED (A6) z/VSE

Date of last change made to the member in format YYMMDD.

Field Name Type/Length Operating System
DATE-CREATED (A6) z/VSE

Creation date of member in format YYMMDD.

Field Name Type/Length Operating System
DATX-CHANGED (D) z/VSE

Date of last change made to the member in Natural format.

Field Name Type/Length Operating System
DATX-CREATED (D) z/VSE

Creation date of member in Natural format.

Field Name Type/Length Operating System
DSNAME (A54) z/OS, z/VSE, BS2000/OSD

Fully qualified dataset name.

Field Name Type/Length Operating System
ELEMENT (A64) BS2000/OSD

Name of LMS element.

Field Name Type/Length Operating System
ELEMENT-TYPE (A8) BS2000/OSD

Type of LMS element.

Field Name Type/Length Operating System
ELEMENT-VERSION (A24) BS2000/OSD

Version of LMS element.

Field Name Type/Length Operating System
EXEC-PROTECTION (A5) BS2000/OSD

Protection attributes of element for EXECUTION.

Possible values are Y (yes) or N (no).

Protection Attribute Meaning
Byte 0: Special protection.
Byte 1: OWNER can access.
Byte 2: GROUP can access.
Byte 3: OTHERS can access.
Byte 4: Password defined.
Field Name Type/Length Operating System
GENERATION (N9) z/OS

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

Field Name Type/Length Operating System
LIBRARY (A8) z/VSE

Name of library.

Field Name Type/Length Operating System
LIBRARY-BLOCKS-USED (N7) z/VSE

Relevant when LIST-SUBLIBS=YES. Number of blocks used by the library.

Field Name Type/Length Operating System
LONG-ALIAS (A3) z/OS

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 Operating System
MEMBER (A10) z/OS, z/VSE

Name of member.

Field Name Type/Length Operating System
MEMBER-COUNT (N5) z/VSE

Relevant when LIST-SUBLIBS=YES. Number of members in sublibrary.

Field Name Type/Length Operating System
MEMBER-LONG-NAME (A253) z/OS

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 Operating System
MEMBER-TTR (B4) z/OS
Field Name Type/Length Operating System
MEMBER-TYPE (A8) z/VSE

Member type.

Field Name Type/Length Operating System
MODIF-DATE (A14) BS2000/OSD

Date of last modification to the element.

Field Name Type/Length Operating System
MODIF-TIME (A8) BS2000/OSD

Time of last modification to the element.

Field Name Type/Length Operating System
MODULE-ATTRIBUTES (A253) z/OS, z/VSE

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 (z/OS only).
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 (z/OS only).
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 Operating System
MODULE-LENGTH (N11) z/OS

Length of module in bytes.

Field Name Type/Length Operating System
NUMBER-OF-OCCURRENCES (N7) z/OS

Number of records which contain the requested string.

Field Name Type/Length Operating System
OPTIONS (A80) z/OS
Option Explanation
ARC Get list of archived members (CA-Librarian access method).
Field Name Type/Length Operating System
PASSWORD (A8) z/OS, z/VSE, BS2000/OSD

Password for protected datasets.

Field Name Type/Length Operating System
PRODUCT (A1) z/OS, BS2000/OSD

Access method used. Possible options:

Option Explanation
L CA-Librarian
M BS2000/OSD LMS
P CA-Panvalet
Field Name Type/Length Operating System
RECORD (A200) z/OS

String for which SCAN is to be performed.

Field Name Type/Length Operating System
READ-PROTECTION (A5) BS2000/OSD

Protection attributes of element for READ. Possible values are Y (yes) or N (no).

Protection Attribute Meaning
Byte 0: Special protection.
Byte 1: OWNER can access.
Byte 2: GROUP can access.
Byte 3: OTHERS can access.
Byte 4: Password defined.
Field Name Type/Length Operating System
RECORD-COUNT (N7) z/VSE

Number of records in member.

Field Name Type/Length Operating System
STORE-FORM (A1) BS2000/OSD

Store form of element. Possible options:

Option Explanation
D Delta
V Full
Field Name Type/Length Operating System
SUB-LIBRARY (A8) z/VSE

Name of sublibrary.

Field Name Type/Length Operating System
SUB-LIBS (A3) z/VSE

Specify YES to return sublibrary names.

Field Name Type/Length Operating System
TIME-CHANGED (N7) z/VSE

Time of last change made to the member.

Field Name Type/Length Operating System
TIME-CREATED (N7) z/VSE

Creation time of member.

Field Name Type/Length Operating System
USER-DATA (A120) z/OS, z/VSE

User data for the member.

z/OS: 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 Operating System
USER-DATA-HEX (B120) z/OS, z/VSE

User data for the member in hexadecimal format.

Field Name Type/Length Operating System
USER-DATA-LENGTH (N3) z/OS, z/VSE

Length of user data for the member.

Field Name Type/Length Operating System
USER-DATE (A14) BS2000/OSD

Date the user specified for the element.

Field Name Type/Length Operating System
USER-DATX (D) BS2000/OSD

Date the user specified for the element in Natural format.

Field Name Type/Length Operating System
USER-TIME (A8) BS2000/OSD

Time the user specified for the element.

Field Name Type/Length Operating System
USER-TIMX (T) BS2000/OSD

Time the user specified for the element in Natural format.

Field Name Type/Length Operating System
VERSION (A2) z/OS

Version of CA-Panvalet access method.

Field Name Type/Length Operating System
VOLSER (A6) z/OS, z/VSE

Volume serial number.

Field Name Type/Length Operating System
VSAM-CATALOG (A8) z/VSE

Name of the VSAM catalog where the library is kept.

Field Name Type/Length Operating System
WRITE-PROTECTION (A5) BS2000/OSD

Protection attributes of element for WRITE.

Possible values are Y (yes) or N (no).

Protection Attribute Meaning
Byte 0: Special protection.
Byte 1: OWNER can access.
Byte 2: GROUP can access.
Byte 3: OTHERS can access.
Byte 4: Password defined.

Default Order of Data Returned

In z/OS, members are presented in ascending order.

In z/VSE, members are presented in ascending order, grouped by member type.