Guardian Procedure Calls Reference Manual

Parameters
filenum
input, output
(for AWAITIO)INT:ref:1
(for AWAITIOX[L])INT .EXT:ref:1
is the number of an open file. If a particular filenum is passed, AWAITIO[X|XL] applies to
that file.
If filenum is passed as -1, the call to AWAITIO[X|XL] 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|XL] returns into filenum the file number associated with the completed operation.
buffer-addr
output
(for AWAITIO)WADDR:ref:1
returns the address of the buffer specified when the operation was initiated.
(for AWAITIOX[L])EXTADDR .EXT:ref:1
returns the relative extended address of the buffer specified when the operation was initiated.
If the actual parameter is used as an address pointer to the returned data and is declared in
the form INT .EXT buffer-addr, it must be passed to AWAITIO[X|XL] in the form
@buffer-addr.
count-transferred
output
(for AWAITIO)INT:ref:1
(for AWAITIOX)INT .EXT:ref:1
(for AWAITIOXL)INT(32) .EXT:ref:1
returns the count of the number of bytes transferred because of the associated operation.
tag
output
(for AWAITIO)INT(32):ref:1
(for AWAITIOX)INT(32) .EXT:ref:1
(for AWAITIOXL)INT(64) .EXT:ref:1
returns the application-defined tag that was stored by the system when the I/O operation
associated with this completion was initiated. The value of tag is undefined if no tag was
supplied in the original I/O call. If the completed I/O operation has a 32-bit tag, the 64-bit
tag is in the sign-extended value of the 32-bit tag.
78 Guardian Procedure Calls (A-B)