Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-186
FILENAME_FINDSTART_ Procedure
The default value is 0. See “Considerations” and “Device Type Considerations.”
startname:length input: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_ will return this
name (if it exists).
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_. A process can have up to 16 concurrent searches.
(Having more than 16 searches causes FILENAME_FINDSTART_ to fail with error
34.) When finished searching, you should call FILENAME_FINDFINISH_ with
searchid to release the resources.
•
The file-name pattern supplied in search-pattern determines the kind of names
that will be returned by FILENAME_FINDNEXT_ and also restricts the range of
name values. For example, \* will return node names; $* will return device names
and process file names. Subvolume names can be retrieved with file-name
patterns such as $VOL.*.
More than one level in the file-name pattern can contain asterisks and question
marks. Note that a file-name pattern such as *.*.* designates not only disk files but
also I/O subdevices and processes that have two levels of qualifiers.
See Appendix D, File Names and Process Identifiers
for the definition of file-name
pattern.
•
A search for qualifier names of a process (for example, qualifier #TERM1 of the
process $TERM.#TERM1) can be performed if both of the following are true:
•
The process that is the target of the search called the PROCESS_SETINFO_
procedure and set attribute 49 to 1 to enable the receipt of the subordinate
name inquiry system message (-107).
•
options.<11> of the FILENAME_FINDSTART_ procedure is set to 0.
<15>
If
startname is supplied, and if the first name returned would be
startname, then that name is to be skipped and the following name
should be returned.