SAS Library: _getMembers

SAS Library: _getMembers

Conditionally retrieves the members of a SAS Library object into an SCL list

Syntax
_getMembers List Items
Details

Syntax

CALL SEND (library-object-id, '_getMembers', members-list<, select-exclude><, item-mask><, options>);

Argument Type Description

members-list
N specifies the identifier of an SCL list. Each entry in members-list corresponds to a SAS library member and is a sublist containing the items in Table 2. Specifymembers-list as a numeric variable that is initialized either to 0 or to a valid list identifier. If the value ofmembers-list is 0, then _getMembers creates a new list, fills it with the members of the SAS Library object,and returns the list identifier. If members-list is nonzero, then it must be a valid list identifier, otherwise the program halts with an error.

select-exclude
C specifies the entries that are returned in members-list. Uses this form:

<item-name='item-values'

...<item-name-n='item-values'>>

The select-exclude argument contains one or more blank-separated select-exclude expressions where item-name is one of the item names from members-list, and item-values is a blank-separated string of possible values for the given item name. To exclude entries with a certain value for an item-name, precede that value with a "not" character, for example '^' or '¬', in the select-exclude expression.

item-mask
C specifies the named items that are included in each entry of members-list. The item-mask argument is a blank-separated string of the item names from members-list. To exclude an item from each entry of members-list, precede it with a "not" character, for example, '^' or '¬'.

options
C determines the options for returning the information:

'APPEND'
appends any members entries to members-list; the members-list argument is cleared by default

'LABEL' returns data set label information for data set members; is off by default

_getMembers List Items
List item Type Description

LIBNAME C the libref of the library member

MEMNAME C the member name of the library member

MEMTYPE C the member type of the library member

TYPE C if the member is a data set, TYPE contains the data set type of the library member

LABEL C if the member is a data set, LABEL contains the data set label. LABEL is included only if 'LABEL' is specified for _getMembers.

***_getMembers List Items***
List item	Type	Description
LIBNAME	C	the libref of the library member
MEMNAME	C	the member name of the library member
MEMTYPE	C	the member type of the library member
TYPE	C	if the member is a data set, TYPE contains the data set type of the library member
LABEL	C	if the member is a data set, LABEL contains the data set label. LABEL is included only if `'LABEL'` is specified for _getMembers.

Details

_getMembers and _loadMembers perform the same function except that _getMembers allows you to select the members that are loaded.

The conditions defined by the select-exclude, item-mask, and options arguments determine the items that are returned in the list.

By default, _getMembers clears all items from members-list and fills it with the SAS Library object members. If the 'APPEND' option is specified, the SAS Library object members are appended to the existing members-list.

Chapter Contents
Previous
Next
Top of Page