Guardian Procedure Calls Reference Manual

Licensed to have privileged procedures.1
Not a secondary partition of a partitioned file.0<9>
Is a secondary partition of a partitioned file.1
File contents are valid.0<10>
File contents are probably invalid because a FUP DUP or LOAD, RESTORE, or similar
operation ended abnormally. When this bit is 1, OPEN fails with error 59, although PURGE
will work.
1
Reserved.<11:15>
sync-depth
output
INT:ref:1
If this parameter is specified, the filenum parameter must be specified and must contain the
number of an open file. FILEINFO returns the sync depth (or receive depth for $RECEIVE) of
the file.
next-open-fnum
output
INT:ref:1
If this parameter is specified, the filenum parameter must be specified and must contain the
number of an open file or -1.
If an open file number is specified in filenum, FILEINFO returns the largest number of an
open file whose file number is less than the file number specified in filenum. If there is no
such file, FILEINFO returns -1.
If -1 is specified in filenum, FILEINFO returns the file number of the open file with the largest
file number, or -1 if no files are currently open.
CAUTION: If the BUFFERED option is specified for an nonaudited file, a system failure or
disk-process takeover (with sync-depth = 0) could cause the loss of buffered updates for the file
that an application might not detect or handle properly unless modified.
Table 21 indicates which FILEINFO parameters are valid when specifying the filenum or
file-name parameter.
Table 21 FILEINFO filenum and file-name Parameters
File NameFile NumberParameter
X( [ filenum ] , )
XX, [ error ]
XX, [ file-name ]
XX, [ Idevnum ]
XX, [ devtype ]
XX, [ extent-size ]
XX, [ eof-location ]
X, [ next-record-pointer ]
XX, [ last-modtime ]
XX, [ filecode ]
XX, [ secondary-extent-size ]
FILEINFO Procedure (Superseded by FILE_GETINFOLIST_ Procedure) 557