Data Set Name List

Lists the data sets to scan for or the data set just scanned in conjunction with NWSM_DATA_SET_NAME_LIST.

Syntax

  UINT32   nameSpaceType; 
  UINT32   reserved; 
  UINT8    count; 
  UINT16   namePositions[count]; 
  UINT16   separatorPositions[count]; 
  UINT16   nameLength; 
  STRING   name[nameLength];

Fields

nameSpaceType: Specifies the name space type of the name (see nameSpaceType Values)
reserved: Is reserved for future use.
count: Specifies the size of namePositions and separatorPositions.
namePositions: Specifies the beginning position of each path node in name.
separatorPositions: Specifies the beginning position of each separator name.
nameLength: Specifies the length of name including the NULL terminator.
name: Specifies a NULL-terminated or fully qualified path string.

Remarks

The values that can set for nameSpaceType is listed in the following table.

Value	Description
0xFFFFFFFE	NWSM_TSA_DEFINED_RESOURCE_TYPE: name contains a primary resource.
0xFFFFFFFC	NWSM_DIRECTORY_NAME_SPACE: name contains a directory service path.
0x000	DOSNameSpace: name contains a DOS path in MBCS format.
0x001	MACNameSpace: name contains a Macintosh path in MBCS format.
0x002	NFSNameSpace: name contains an NFS path in MBCS format.
0x003	FTAMNameSpace: name contains an FTAM path in MBCS format.
0x004	OS2NameSpace: name contains an OS/2 path in MBCS format.
0x100	DOSNameSpaceUtf8Type: name contains a DOS path in UTF-8 format.
0x101	MacNameSpaceUtf8Type: name contains a Macintosh path in UTF-8 format.
0x102	NFSNameSpaceUtf8Type: name contains an NFS path in UTF-8 format.
0x104	LongNameSpaceUtf8Type: name contains a DOS path in UTF-8 format.

If a data set is a primary resource, nameSpaceType must be set to NWSM_TSA_DEFINED_RESOURCE_TYPE.

If count is zero, namePositions and separatorPositions are not used.

For more information on name positions, see Path Information and Using Resources with Selection Options. Although the name list example is a selection list, the same principles apply.

name will have a separator at the end for a parent terminal node.

NOTE:name must be properly formatted when passed to NWSMTSIsDataSetExcluded.