Guardian Procedure Calls Reference Manual

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.
For the definition of file-name pattern, see Appendix D: File Names and Process Identifiers.
resolve-level
input
INT:value
if present, indicates how fully qualified the names returned by FILENAME_FINDNEXT[64]_ are
to be specified. The value indicates the part that is the leftmost component of a returned name.
If this parameter is omitted, the default value is -1. Valid values are:
Node name-1
Destination name (for example, volume, device, or process)0
First qualifier (for example, subvolume)1
Second qualifier (file identifier if disk file)2
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[64]_ 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 parameter is omitted or equal to -1, device type
is disregarded when selecting file names. See Device Type Considerations (page 581).
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[64]_ 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 (page 581).
FILENAME_FINDSTART_ Procedure 579