SAS/C Library Reference, Vol. 1

cmsdnext -- Find the Next CMS Fileid Matching a Pattern

SYNOPSIS

 #include <cmsio.h>

 int cmsdnext(struct FILEINFO *info);

DESCRIPTION

cmsdnext finds the next CMS fileid matching a pattern previously defined in a call to cmsdfind. The info function is a FILEINFO structure that has been filled in by cmsdfind. If a match is found, then the information for the new match is placed in the structure pointed to by info. Refer to the description of cmsdfind for a listing of FILEINFO.

RETURN VALUES

Refer to the RETURN VALUE section of cmsdfind.

CAUTION

Refer to the CAUTION section of cmsdfind.

Disk I/O is not permitted between calls to cmsdfind and cmsdnext if the I/O is to the same disk that is being searched by cmsdfind and cmsdnext. You also cannot use cmspid between cmsdfind and cmsdnext if these functions refer to the same disk. Note that if you run VM/XA or VM/ESA, you can use cmsffind and cmsfnext in place of cmsdfind and cmsdnext to avoid these restrictions.

EXAMPLE

See the example for cmsdfind.

RELATED FUNCTIONS

cmsdfind