Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-185
FILENAME_FINDSTART_ Procedure
parameter is omitted or equal to -1, device type is disregarded when selecting file
names. See “Device Type Considerations.”
device-subtype input
INT:value
if present and not equal to -1, specifies a device-subtype value to be used in
selecting returned names. A name returned by FILENAME_FINDNEXT_ must
represent, or must not represent (depending on the value of
options), an entity of
the specified device subtype. If this parameter is omitted or equal to -1, device
subtype is disregarded when selecting file names. See “Device Type
Considerations.”
options input
INT:value
specifies further options. The bits, when equal to 1, indicate the following:
Bit Meaning
<0:7
>
Reserved (specify 0)
<8> 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.
<9> 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
messages sent to $RECEIVE rather than through the output parameters
of FILENAME_FINDNEXT_. See “Considerations.”
<10> Device simulation by subtype 30 processes is not to be supported.
<11>
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 search for
qualifier names, the subordinate name inquiry system message (-107) is
not sent by FILENAME_FINDNEXT_. The PROCESS_SETINFO_
procedure enables the receipt of this system message. For more
information on this system message, refer to the
Guardian Procedure
Errors and Messages Manual.
<12> 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.”
<13>
If
device-subtype is supplied, a file name must not match the device
subtype value in order to be returned.
<14>
If
device-type is supplied, a file name must not match the device type
value in order to be returned.