DESERV provides interfaces to access the directories of PDS and PDSE data sets. With DESERV you can get all the directory entries for a PDSE or selected directory entries for a PDS or a PDSE with the GET_ALL and GET functions, respectively. You can get generation data for a member or all members of PDSE with the GET_G and GET_ALL_G functions, respectively. You can delete or rename a list of members in a PDSE with the DELETE and RENAME functions. You can alter the attributes of a program object (in a PDSE) with the UPDATE function.

All functions return results to the caller in areas provided by the invoker or areas returned by DE services. All functions provide status information in the form of return and reason codes. The IGWDES macro maps all the parameter areas.

DE services also introduces a new format directory entry called system-managed directory entry (SMDE), mapped by the IGWSMDE macro. The SMDE is an extended and extensible version of the directory entry produced by BLDL. Its chief features are that it provides users with long name support, longer application (user) data, load module indication and version control. Table 1 describes all the functions provided by DESERV. This topic discusses the GET, GET_ALL, GET_ALL_G, GET_G, RELEASE, GET_NAMES, and UPDATE functions. The DELETE and RENAME functions are described later.

Table 1. DE services function summary

Function	Description
GET	Obtain directory entries based on a list of names, or a BLDL directory entry to establish connections to these members.
GET_ALL	Obtain all directory entries for each member name. Optionally, establish connections to all names in the library.
GET_ALL_G	Obtain all directory entries for all available generations for each member.
GET_G	Obtain directory entries for all available generations for a member.
GET_NAMES	Obtain buffer filled with the names and directory entries of each member name (primary and aliases) defined to a specified program object member of a PDSE.
DELETE	DELETE one or more PDSE member names. For more information see Deleting a PDSE Member.
RELEASE	Remove selected connections established by one or more previous calls to the GET or the GET_ALL functions. Or, remove all connections established by a previous call to the GET or the GET_ALL function.
RENAME	Rename one or more PDSE members. For more information see Renaming a PDSE Member.
UPDATE	Let caller update select fields of the directory entries of PDSE program objects.