Envoy Application Programming Manual

File-System Procedures
Envoy Application Programming Manual—427159-001
C-5
AWAITIO[X]
currently has opened, filenum is -1. When the AWAITIO[X] call completes
processing, Envoy sets filenum to reflect the file number of the particular line on
which the I/O completion occurred. For example, if you use SETMODE 30 to allow
nowait I/O operations to complete in any order, you should use AWAITIO[X] with
filenum -1 to find out which operation has completed.
buffer-address output
INT:ref:1 (Use with AWAITIO)
returns the address of the buffer specified when the operation was initiated. Note
that if the variable is declared in the form INT .buffer and is to be used as an address
pointer to the returned data, the variable name must be passed to AWAITIO in the
form “@buffer” instead.
INT .EXT:ref:1 (Use with AWAITIOX)
returns the relative extended address of the buffer specified when the operation was
initiated.
count-transferred output
INT:ref:1 (Use with AWAITIO)
INT .EXT:ref:1 (Use with AWAITIOX)
returns the count of the number of bytes transmitted or received by the completed
I/O operation.
tag output
INT(32):ref:1 (Use with AWAITIO)
INT(32) .EXT:ref:1 (Use with AWAITIOX)
returns the application-defined tag stored by the system when the operation
associated with this completion was initiated.
time-limit input
INT(32):value (Use with both AWAITIO and AWAITIOX)
indicates whether the process waits for completion instead of checking for
completion. The following timelimit values indicate whether the process checks
for completion, waits a specified amount of time for a completion, or waits
indefinitely for a completion:
0D = Check for completion and then return control to the calling process.
If the AWAITIO[X] call can logically complete an incomplete I/O
operation, it does so. If not, file-system error 40 is returned and
control passes immediately to the next sequential statement or
instruction in the calling process. The operation is not cancelled.