Returns the first data set name contained in NWSM_DATA_SET_NAME_LIST or NWSM_SELECTION_LIST.
#include <smsutapi.h>
CCODE NWSMGetFirstName (
void SM_HUGE *buffer,
NWSM_DATA_SET_NAME SM_HUGE *name,
SMS_HANDLE SM_HUGE *handle);
(IN) Points to the NWSM_DATA_SET_NAME_LIST or NWSM_SELECTION_LIST structure plus its accompanying name list.
(OUT) Points to the data set name.
(OUT) Points to the name handle used for all subsequent get name functions.
The following table lists the return values associated with the function.
NWSMGetFirstName returns the first name contained in buffer. To get the next name in the list, call NWSMGetNextName. To end the retrieval of data set names, call NWSMCloseName.
buffer could contain a list of terminal path names, full path names, or a single TSA defined object.
If NWSMGetFirstName returns NWSMUT_NO_MORE_NAMES, do not call NWSMCloseName.
If the creator name space was requested when buffer was built, name contains the data set name as it appears under that name space.