Exchange/SNA Manual

FILEINFO Procedure
Exchange/SNA System Procedure Calls
104700 Tandem Computers Incorporated 5–11
FILEINFO Procedure The FILEINFO procedure returns the number of the last error reported by the
Exchange/SNA line server on the specified subdevice.
CALL FILEINFO ( filenum
, error );
filenum
INT:value
is the file number of a previously opened subdevice supported by the
Exchange/SNA line server. The number you specify here is the number returned
by the call to OPEN that opened the subdevice.
If your program is calling FILEINFO to retrieve the number of an error that
occurred while trying to open the line server, filenum must equal -1.
error
INT:ref:1
returns the number of the error that occurred during the last operation on the
subdevice.
Considerations The FILEINFO procedure returns the number of the last error reported by the
Exchange/SNA line server on the specified subdevice. Your program can then
determine what to do next based on the particular error that occurred.
For wait I/O operations, the actual occurrence of an error is determined by testing the
condition code immediately after each procedure call. Any condition code other than
zero (CCE or =) indicates that an error or warning occurred. Your program should
always check the condition code after every procedure call that operates on the line
server, and your program should always call FILEINFO if the condition code is not
equal to zero.
For nowait I/O operations, the actual occurrence of an error is determined by testing
the condition code immediately after the call to AWAITIO that completes the nowait
I/O operation. You should also test the condition code after the call that starts the
nowait I/O operation. However, this test only tells you whether the nowait I/O
operation started successfully, not whether the operation completed successfully.
For a list of the error numbers returned by the line server and their meanings, see
“Error Handling” in Section 4.