Guardian Procedure Calls Reference Manual

Table 21 FILEINFO filenum and file-name Parameters (continued)
File NameFile NumberParameter
XX, [ current-record-pointer ]
X, [ open-flags2 ]
X, [ subdev ]
X, [ owner ]
X, [ security ]
X, [ num-extents-allocated ]
X, [ max-file-size ]
X, [ partition-size ]
X, [ num-partitions ]
X, [ file-type ]
XX, [ maximum-extents ]
XX, [ unstructured-buffer-size ]
XX, [ more-flags ]
X, [ sync-depth ]
X, [ next-open-fnum ]
Condition Code Settings
indicates that an error occurred; the error number returns in error.< (CCL)
indicates that FILEINFO executed successfully.= (CCE)
indicates that an error occurred; the error number returns in error.> (CCG)
Considerations
• Specifying a file number or a file name
If FILEINFO is called specifying filenum, the returned information is obtained from the access
control block. If it is called specifying file-name but not filenum, the returned information
is obtained from the file label. There is no check to see if the file is actually opened when
file-name is specified.
• Error returned when a file number is specified
If FILEINFO is called specifying filenum, the last error associated with this file number is
returned. If the file is opened more than once, only errors associated with filenum are
returned; errors for the other opens are ignored. Note that the error returned might not originate
from the last operation on the file. If there is an error in the call to FILEINFO, such as an
incorrect parameter, that error is returned in error.
• Error returned when only a file name is specified
If FILEINFO is called specifying file-name but not filenum, only a small number of errors
can be returned. No errors relating to any current open operation of the file can be returned.
Typical errors are:
The file name is not a disk file name2
File does not exist11
558 Guardian Procedure Calls (F)