Guardian Procedure Calls Reference Manual

options
input
INT:value
specifies further options. The bits, when equal to 1, indicate:
MeaningBit
Reserved (specify 0).<0:7>
If a physical file corresponding to a NonStop Storage Management Foundation (SMF) logical file is
encountered, the name of the physical file is to be returned.
<8>
The search is to be executed in a nowait manner. When this option is specified, some parts of the search
processing are asynchronous with respect to the caller, and the results of the search are returned in system
<9>
messages sent to $RECEIVE rather than through the output parameters of FILENAME_FINDNEXT[64]_.
See Considerations.
Device simulation by subtype 30 processes is not to be supported.<10>
The search is not to include subprocesses; that is, the search is to ignore qualifier names that are
subordinate to names of user processes (other than device simulation processes). Because there is no
<11>
search for qualifier names, the subordinate name inquiry system message (-107) is not sent by
FILENAME_FINDNEXT[64]_. The PROCESS_SETINFO_ procedure enables the receipt of this system
message. For more information on this system message, see the Guardian Procedure Errors and Messages
Manual.
If an entity is encountered that is offline (that is, the system is not connected or the device is down), an
error is to be reported. When this bit is zero, such entities are sometimes ignored. See Error Handling
(page 582).
<12>
If device-subtype is supplied, a file name must not match the device subtype value in order to be
returned.
<13>
If device-type is supplied, a file name must not match the device type value in order to be returned.<14>
If startname is supplied, and if the first name returned would be startname, then that name is to be
skipped and this name is returned.
<15>
The default value is 0. See Considerations and Device Type Considerations (page 581).
startname:length
input
STRING .EXT:ref:*, INT:value
if supplied and if length is not 0, specifies a file name that indicates where, within the set of
file names that meet the search criteria, selection should begin. If used, the value of startname
must be exactly length bytes long. It must be a valid file name and must fall within the set of
names described by search-pattern. Unless options.<15> = 1, the first call to
FILENAME_FINDNEXT[64]_ will return this name (if it exists).
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• You must call FILENAME_FINDSTART_ to initiate a search for named entities. If no error occurs,
FILENAME_FINDSTART_ returns a searchid value that you use to identify the particular
search when making subsequent calls to FILENAME_FINDNEXT[64]_. A process can have up
to 16 concurrent searches. (Having more than 16 searches causes FILENAME_FINDSTART_
580 Guardian Procedure Calls (F)