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.