Guardian Procedure Calls Reference Manual

Invalid file name13
Device does not exist14
Access to the system specified in file-name failed249
The system specified in file-name is not part of the network250
In general, to obtain information about errors relating to operations on open files (including
failures to open a file), use the file number form of this request. For information about files that
do not have to be opened, use the file name form.
• Waited open that failed
The error number of a preceding awaitio operation on any file or a waited open operation
that failed can be obtained by passing a -1 in the filenum parameter. The error number
returns in error.
• Disk file considerations
The error number of a preceding CREATE or PURGE that failed can be obtained by passing
a -1 in the filenum parameter. The error number returns in error.
• Calling FILEINFO subsequent to a CLOSE
File-system error 16 (file not open) returns if FILEINFO is called subsequent to a CLOSE.
• FILEINFO and high-PIN processes
If you use FILEINFO to request the file name of an unnamed high-PIN process that was opened
using FILE_OPEN_, an error is returned.
• Calling FILEINFO after ENDTRANSACTION or ABORTTRANSACTION
If there is a delay in the completion of a TMF transaction against a file after a call to
ENDTRANSACTION or ABORTTRANSACTION, and if the file is closed by the last opener,
there is a period of time during which FILEINFO reports that the file is open (more-flags.<7>
= 1) and OPENINFO reports that the file is closed.
• Referencing Enscribe format 2 files with extent size greater than 65535 or OSS files larger
than approximately 2 gigabytes
If the file being referenced is an Enscribe format 2 file and the extent size exceeds 65535 or
OSS file larger than approximately 2 gigabytes, item codes will return -1 with no error
indication.
Examples
CALL FILEINFO ( FILENUM , ERROR ); ! get error of read
! operation.
CALL FILEINFO ( , , FILE^NAME , , , , , , , , , , , , OWNER );
FILEINFO Procedure (Superseded by FILE_GETINFOLIST_ Procedure) 559