Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-44
AWAITIO[X] Procedures
Syntax for C Programmers
•
The function value returned by AWAITIO[X], which indicates the condition code,
can be interpreted by the
_status_lt(), _status_eq(), or _status_gt()
macros (defined in the file
tal.h)
Syntax for TAL Programmers
Parameters
filenum input, output
INT:ref:1 (Use with AWAITIO)
INT .EXT:ref:1 (Use with AWAITIOX)
is the number of an open file. If a particular
filenum is passed, AWAITIO[X]
applies to that file.
If
filenum is passed as -1, the call to AWAITIO[X] applies to the oldest
incomplete operation pending on each file. The specific action depends on the
value of the
timelimit parameter (see the timelimit parameter below).
AWAITIO[X] returns into
filenum the file number associated with the completed
operation.
#include <cextdecs(AWAITIO)>
_cc_status AWAITIO ( short _near *filenum
,[ short _near *buffer-addr ]
,[ short _near *count-transferred ]
,[ __int32_t _near *tag ]
,[ __int32_t timelimit ] );
#include <cextdecs(AWAITIOX)>
_cc_status AWAITIOX ( short *filenum
,[ __int32_t *buffer-addr ]
,[ short *count-transferred ]
,[ __int32_t *tag ]
,[ __int32_t timelimit ]
,[ short *segment-id ] );
CALL AWAITIO[X] ( filenum ! i,o
,[ buffer-addr ] ! o
,[ count-transferred ] ! o
,[ tag ] ! o
,[ timelimit ] ! i
,[ segment-id ] ); ! o (AWAITIOX only)