Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-43
AWAITIO[X] Procedures
AWAITIO[X] Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
OSS Considerations
Related Programming Manual
Summary
The AWAITIO and AWAITIOX procedures are used to complete a previously initiated
I/O operation. Use AWAITIOX with the extended 32-bit (or ‘X’) versions of the I/O
procedures such as READX, WRITEREADX, and so forth. Use AWAITIO with the
16-bit versions such as READ, WRITEREAD, and so forth. Use AWAITIO[X] to:
•
Wait for the operation to complete on
•
A particular file — Application process execution suspends until the completion
occurs. A timeout is considered to be a completion in this case.
•
Any file or for a timeout to occur — A timeout is not considered a completion in
this case.
•
Check for the operation to complete on
•
A particular file — The call to AWAITIO[X] immediately returns to the
application process, regardless of whether there is a completion or not. (If
there is no completion, an error indication is returned.)
•
Any file
If AWAITIO[X] is used to wait for a completion, you can specify a time limit.