Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-184
FILENAME_FINDSTART_ Procedure
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the operation.
searchid output
INT .EXT:ref:1
returns a value that identifies the search request for other file-name inquiry
procedures.
search-pattern:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, contains a valid file-name pattern that specifies
the set of names to be searched. If used, the value of
search-pattern must be
exactly
length bytes long. A partially qualified file-name pattern is resolved using
the contents of the caller’s =_DEFAULTS DEFINE. “*” is the default search
pattern.
See Appendix D, File Names and Process Identifiers
for the definition of file-name
pattern.
resolve-level input
INT:value
if present, indicates how fully qualified the names returned by
FILENAME_FINDNEXT_ are to be. The value indicates the part that should be the
leftmost component of a returned name. If this parameter is omitted, the default
value is -1. Valid values are:
-1 Node name
0 Destination name (for example, volume, device, or process)
1 First qualifier (for example, subvolume)
2 Second qualifier (file identifier if disk file)
The specified level must not be further to the right than the level in
search-
pattern that contains the first asterisk (*) or question mark (?).
device-type input
INT:value
if present and not equal to -1, specifies a device-type 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 type (or an entity that has a parent device of that device type). If this