Guardian Procedure Calls Reference Manual

Parameters
filenum
input
INT:value
is the number of an open file that identifies the file whose characteristics are to be returned.
Either filenum or file-name must be specified; if both are passed, then file-name is set
to the file name associated with filenum. If filenum is not specified, error 2 is returned for
non-disk files.
error
output
INT:ref:1
returns the error number associated with the last operation on the file. filenum or file-name
can be specified with this parameter, but see Considerations (page 558) before passing these.
For error recovery information, see the Guardian Procedure Errors and Messages Manual.
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.
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.)
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 fields is returned, one entry for each of 16 possible
partitions:
ldevnum of partition 0[0]
ldevnum of partition 1[1]
.
.
.
ldevnum of partition 15.[15]
FILEINFO Procedure (Superseded by FILE_GETINFOLIST_ Procedure) 551