Guardian Procedure Calls Reference Manual

In general, it is not worthwhile to retry errors that do not return a name, because the condition
that caused the error is likely to recur.
For files residing on Storage Management Foundation (SMF) virtual disks, call
FILE_GETINFOLISTBYNAME_ after the file name is returned by FILENAME_FINDNEXT[64]_.
Without the additional call, FILENAME_FINDNEXT[64]_ will always return 0 as object type.
Nowait Considerations
• If you specify the nowait option (options.<9> = 1) to FILENAME_FINDSTART_, the results
are returned in the nowait FILENAME_FINDNEXT[64]_ completion message (-109), not in the
output parameters of the procedure. The format of this completion message is described in
the Guardian Procedure Errors and Messages Manual. If error is not 0, no completion
message is sent to $RECEIVE. Errors can be reported either on return from the procedure or
through the completion message sent to $RECEIVE.
• Some errors are always returned in error. One of these is error 28, which occurs if you call
FILENAME_FINDNEXT[64]_ a second time on a particular searchid without having completed
the previous call by reading the results from $RECEIVE.
Related Programming Manual
For programming information about the FILENAME_FINDNEXT[64]_ procedures, see the Guardian
Programming Reference Summary.
FILENAME_FINDNEXT[64]_ Procedures 577