Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-49
AWAITIO[X] Procedures
operation should not be used for any other purpose (including another read) until
the read operation has been completed with a call to AWAITIO[X].
•
No nowaited operations
You should not call AWAITIO[X] unless you initiate a nowait operation prior to the
call; otherwise, an error indication returns (CCL). A subsequent call to
FILE_GETINFO_ or FILEINFO shows that an error 26 occurred.
•
Error handling
If an error indication returns (that is, condition code is CCL or CCG), you can pass
the file number returned by AWAITIO[X] to the FILE_GETINFO_ or FILEINFO
procedure to determine the cause of the error. If
filenum = -1 (that is, any file) is
passed to AWAITIO[X] and an error occurs on a particular file, AWAITIO[X] returns
the file number associated with the error in
filenum.
•
AWAITIO[X] and edit files
If AWAITIO[X] returns after completion of an I/O operation against an EDIT file that
was accessed using the IOEdit procedures, then you must call the
COMPLETEIOEDIT procedure to inform the IOEdit software that the operation has
finished.
•
AWAITIO[X] completion summary
How AWAITIO[X] completes depends on whether the
filenum parameter
specifies a particular file or any file and on what the value of
timelimit is when
passed with the call. The action taken by AWAITIO[X] for each combination of
filenum and timelimit is summarized in Table 2-3.
•
AWAITIO[X] operation
The operation of the AWAITIO[X] procedure is shown in Figure 2-1
.