|
Description
|
Reads the partitioned dataset directory of the pre-allocated ddname provided, and returns the member names in a REXX compound variable. The 0 stem of the variable will contain the total number of members returned. |
|
Syntax
|
EVORXDIR('ddname','variable'[,'count'][,'directory'][,'prefix'])
where:
ddname
|
An existing symbolic DD name (1 to 8 characters) |
variable
|
A 1-to-17-character name used to build a compound variable containing the member names in the PDS. |
count
|
(Optional) The maximum number of names returned. The default maximum is 1000 names. |
|
|
|
Syntax
|
directory
|
(Optional) Either ‘YES’ or ‘NO’, indicating whether to return the directory user data, the approximately 60 bytes of user halfwords (e.g., ISPF or link-edit information). When used, the member name will be the first word of the compound variable, followed by the user data. |
prefix
|
(Optional) Filter the output so that only member names with this prefix are returned. |
|
|
|
Return Value
|
A variable can be assigned to the command to hold one of these return texts:
OK |
Read of the dataset was successful |
ERROR IN SPECIFYING FUNCTION |
An incorrect parameter was passed, either the variable name is too long, or the count exceeds the maximum size allowed |
ERROR OPENING PDS DATASET |
The named ddname failed to open. |
|
|
|
Return Value
|
ERROR READING PDS DATASET
|
There was a failure reading the ddname |
STORAGE REQUEST FAILED
|
The function was unable to allocate enough memory to hold the complete list of dataset members. |
|
|
|
REXX Example
|
x = EVORXDIR('LOADLIB','MEMBER')
x = EVORXDIR('LOADLIB','MEMBER','9999','YES')
|