Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-153
FILEINFO Procedure (Superseded by
FILE_GETINFOLIST_ Procedure )
file-name input, output
INT:ref:12
specifies or returns the internal-format file name of this file. Either
filenum or
file-name must be passed. If both are passed, file-name returns with the
name of the file associated with
filenum; if file-name is passed without
filenum, error 2 is returned for nondisk files.
ldevnum output
INT:ref:1 or INT:ref:16
is the logical device number of the device where this file resides. If the file is a
process file, -1 is returned.
INT:ref:1 is used if the file is not partitioned or if
filenum is omitted.
INT:ref:16 is used if the file is partitioned.
For partitioned files, an array of
ldevnum is returned, one entry for each of 16
possible partitions:
[0] ldevnum of partition 0
[1] ldevnum of partition 1
.
.
.
[15] ldevnum of partition 15.
If -1 is returned for a partition, the partition is not open.
If the logical device number to be returned exceeds the maximum value allowed,
the value 32767 is returned in
ldevnum and 0 is returned in error, indicating that
no error occurred. (The maximum value allowed for
ldevnum is 65375, and
should therefore be treated as unsigned. Note that no actual logical device will
ever be assigned the value 32767.)
For partitioned files,
ldevnum is set to 32767 and 0 is returned in error if at least
one of the
ldevnum values is greater than 65375.