File	3
Op-Sys	z/OS, z/VSE, BS2000
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.
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

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
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

Creation date of element.

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

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

Fully qualified dataset name.

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

Name of LMS element.

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

Type of LMS element.

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

Version of LMS element.

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

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

Date of last modification to the element.

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

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

Password for protected datasets.

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

Access method used. Possible options:

Option	Explanation
L	CA-Librarian
M	BS2000 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

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

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

Date the user specified for the element.

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

Date the user specified for the element in Natural format.

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

Time the user specified for the element.

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

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

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.