Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-161
FILEINFO Procedure (Superseded by
FILE_GETINFOLIST_ Procedure )
•
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:
2 The file name is not a disk file name
11 File does not exist
13 Invalid file name
14 Device does not exist
249 Access to the system specified in
file-name failed
250 The system specified in
file-name is not part of the network
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.