isCOBOL Evolve : Appendices : Library Routines : C$LIST_DIRECTORY : LISTDIR-OPEN
LISTDIR-OPEN
The LISTDIR-OPEN function searches a directory for a file or subdirectory name that matches a specified name.
Syntax:
 CALL "C$LIST_DIRECTORY" USING LISTDIR-OPEN 
                               directoryName 
                               pattern
                        GIVING listdirHandle
Parameters:
LISTDIR-OPEN
Constant
 
directoryName
PIC X(n)
Specifies the name of an existing the directory.
pattern
PIC X(n)
It specifies a value representing the name to be matched. It can contain wildcard characters, for example, an asterisk (*) or a question mark (?).
Return code:
listdirHandle must be an USAGE HANDLE data item. It receives the handle of the list of matching files and will be used with the LISTDIR-NEXT and LISTDIR-CLOSE functions. It receives 0 if the directory doesn’t exist.