Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-181
FILENAME_FINDNEXT_ Procedure
is a file-system error number indicating the outcome of the operation. Error 1 (end
of file) indicates that no more names are available.
searchid input
INT:value
is the value that was previously returned by FILENAME_FINDSTART_ to identify
the search request.
name:maxlen output:input
STRING .EXT:ref:*, INT:value
contains the name being returned. The level of qualification of the name is
determined by the
resolve-level parameter previously supplied to
FILENAME_FINDSTART_.
maxlen is the length in bytes of the string variable name.
name-length output
INT .EXT:ref:1
is the length in bytes of the value returned in
name.
entity-info output
INT .EXT:ref:5
if present, returns a block of five words that might contain information about the
entity designated by
name. Note that some of the fields do not apply to all kinds of
entities. (None of them apply to nodes.) The fields are:
[0] Device type.
[1] Device subtype.
[2:4] Device-specific information. When the device type is 3 (disk), the
meanings are:
[2] Object type. If greater than 0, this is an SQL object; if equal to 0, this is a
non-SQL disk file; if equal to -1, this is an entire volume or subvolume.
[3] File type. If the entity is a disk file, this is the file type (0 = unstructured, 1
= relative, 2 = entry-sequenced, 3 = key-sequenced); otherwise it is -1.
[4] File code. If the entity is a disk file, this is the file code given to the file;
otherwise it is -1.
For other device types, words [2:4] are not currently defined.
tag input
INT(32):value