Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-164
FILEINQUIRE Procedure (Superseded by
FILE_GETINFOLISTBYNAME_ Procedure )
file-name input
INT:ref:12
is an internal-format file name that identifies the file being inquired about.
Required if
filenumber is not specified. May not be specified if filenumber is
specified. A
define-name can be given for this parameter.
item-list input
INT:ref:*
is an array in which the caller specifies the items of file information to be returned
by the procedure. Each INT element of the array must contain a code from
Table 5-9
.
number-items input
INT:value
is the number of items given in
item-list.
result-buffer output
INT .EXT:ref:*
is the array in which the requested information items are returned. The items are
returned in the order specified in
item-list. Each item begins on an INT
boundary; if the preceding item had a length of an odd number of bytes then an
used byte will occur between the items. The length of each item is given in
Table 5-9
.
result-buffer-length input
INT:value
is the size, in bytes, of the caller’s
result-buffer.
error-item output
INT:ref:1
if present, is returned the index of the item which was being processed when an
error was detected. (The index of the first item in
item-list is 0.)
error-code output
INT:ref:1
if present, is returned the status of the FILEINQUIRE call using standard file-
system error codes.