DESERV—Directory entry services (BPAM)

The DESERV macro performs operations on PDS and PDSE directories.

The DESERV FUNC= parameter specifies the function requested, such as:

GET—retrieve directory information for a PDS or PDSE given a list of names or BLDL entry
GET_ALL—retrieve all member names and directory entries from a PDSE or PDS
RELEASE—removes PDSE connections established by previous DESERV functions such as GET and GET_ALL
GET NAMES—gets a list of names and associated directory data for a member of a PDSE
RENAME PDSE members and alias names
DELETE PDSE entries
UPDATE selected fields of program object directory entries
GET_G— retrieves all the generation information for a single member of a PDSE
GET__ALL_G— retrieves all the generation information for all the members of a PDSE.

DESERV returns directory information in system managed directory entry (SMDE) format depending upon the type of request you specify. The SMDE contains reformatted PDS2 information for a PDS member plus additional information for a PDSE program object. See z/OS DFSMS Using Data Sets for more information on using the DESERV functions.

The DESERV macro may be issued in 24- or 31-bit addressing mode. In either case, all addresses must be valid 31-bit addresses.

The DESERV exit and the PUT function are not documented here. See z/OS DFSMSdfp Advanced Services for more information on these functions.

The syntax for each DESERV function is shown below. Table 1 and Table 2 show the parameters which are either required, optional, or invalid for each of the DESERV functions. The parameter descriptions follow the figures. The return and reason codes for each DESERV function are shown in the figures that follow the parameters.

The parameter list is cleared for the execute form of DESERV (MF=E) if the COMPLETE parameter is specified. This can be used to reset previously used parameters. You are responsible for initializing the parameter list by copying MF=L to dynamic storage for use in MF=E.