Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-187
FILENAME_FINDSTART_ Procedure
For descriptions of the messages and replies that must be supported to search for
qualifier names, refer to the
Guardian Procedure Errors and Messages Manual.
•
The names returned by FILENAME_FINDNEXT_ are returned in a sequence that
is not necessarily alphabetic. (See “Considerations” for the
FILENAME_FINDNEXT_ procedure.) You can specify a starting point in this
sequence other than the normal one by using the
startname parameter of
FILENAME_FINDSTART_ and thereby avoid processing some initial portion of the
sequence. You can do this, for instance, to restart a discontinued search from the
point where it stopped.
•
When using the nowait option (options.<9> = 1), you still call
FILENAME_FINDNEXT_ for each name but the results are returned in a system
message to $RECEIVE rather than in the output parameters of
FILENAME_FINDNEXT_. Refer to the
Guardian Procedure Errors and Messages
Manual for the format of this system message.
The nowait interface guarantees only that device-type simulation and subname
inquiries to user processes are asynchronous to the caller; any other part of a
search might be synchronous (that is, might execute while the caller waits) or
asynchronous in a given software release.
•
The FILENAME_FIND* procedures can be used to search for files on SMF virtual
volumes. However, when searching disk volumes, the names in the special SMF
subvolumes (ZYS* and ZYT*) where SMF physical files reside are not returned by
the FILENAME_FINDNEXT_ procedure except when the search pattern supplied
to the FILENAME_FINDSTART_ procedure includes “ZYS” or “ZYT” as the first
three characters of the subvolume portion of the pattern, or when
options.<8> is
set equal to 1.
Device Type Considerations
•
The device-type parameter can be used to restrict the set of names that are
returned. If it is supplied, a name must represent an entity of the specified device
type to be returned. If
options.<14> is equal to 1, the meaning of device-type
is reversed: all names are returned except those representing entities of the
specified device type. The
device-subtype parameter acts in the same manner
with respect to the device subtype. These parameters do not apply to system
name searches. A typical use might be to restrict a file-name pattern such as *.*.*
to disk files by supplying a
device-type value of 3.
•
Note that if the device-type value is 3, the subordinate name inquiry system
message (-107) is never sent, regardless of the setting of
options.<11>.
•
The system allows certain processes, which are distinguished by having a device
subtype of 30, to simulate device types. During a file name search, these
processes are normally sent a system message inquiring about the device-type
and subtype values they present. The result of this inquiry is used for selection
under the
device-type and device-subtype selection criteria and for
information reporting by FILENAME_FINDNEXT_.