SAS Metalib: _getMembers

SAS Metalib: _getMembers

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

Syntax
_getMembers List Items
Details
See Also

Syntax

CALL SEND (metalib-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. Specify members-list as a numeric variable that is initialized either to
0
or to a valid list identifier. If the value of members-listis
0
then _getMembers creates a new list, fills it with the members of the SAS Metalib 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. Use 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 enables you to select the members and items 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 Logical object members. If 'APPEND' is specified, the Logical object members are appended to the existing members-list.

See Also

_loadMembers.

Chapter Contents
Previous
Next
Top of Page