Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-42
FILENAME_FINDSTART_
Sets up a search of named entities.
resolve-level
options
0
1
2
3
-1
=
=
=
=
=
Unstructured disk file
Relative disk file
Entry-sequenced disk file
Key-sequenced disk file
Not a disk file
[4] File code:
>= 0
-1
=
=
Disk file
Not a disk file
#include <cextdecs(FILENAME_FINDSTART_)>
short FILENAME_FINDSTART_ ( short *searchid /* o */
,[ const char *search-pattern ] /* i */
,[ short length ] /* i */
,[ short resolve-level ] /* i */
,[ short device-type ] /* i */
,[ short device-subtype ] /* i */
,[ short options ] /* i */
,[ const char *startname ] /* i */
,[ short length ] ); /* i */
-1 = Node name
0 = Destination name (for example, device or process)
1 = First qualifier (for example, subvolume)
2 = Second qualifier (file identifier if disk file)
Bits 0-8 Reserved (specify 0).
Bit 9 The search is to be executed in a nowait manner. The results of the search
are returned in system messages sent to $RECEIVE.
Bit 10 Device simulation by subtype 30 devices is not to be supported.
Bit 11 The search is not to include subprocesses.
Bit 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.