Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-45
AWAITIO[X] Procedures
buffer-addr output
WADDR:ref:1 (Use with AWAITIO)
returns the address of the
buffer specified when the operation was initiated.
EXTADDR .EXT:ref:1 (Use with AWAITIOX)
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, then it should be passed to
AWAITIO[X] in the form @
buffer-addr.
count-transferred output
INT:ref:1 (Use with AWAITIO)
INT .EXT:ref:1 (Use with AWAITIOX
returns the count of the number of bytes transferred because of the associated
operation.
tag output
INT(32):ref:1 (Use with AWAITIO)
INT(32) .EXT:ref:1 (Use with AWAITIOX)
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.
timelimit input
INT(32):value (Use with both AWAITIO and AWAITIOX)
indicates whether the process waits for completion instead of checking for
completion. If
timelimit is passed as:
>0DA wait-for-completion is specified. The timelimit parameter
specifies the maximum time (in .01-second units) from the time of
the AWAITIO[X] call that the application process can wait (that is,
be on a wait list) for completion of a waited-for operation.
See “Considerations” for queue files.
=-1DAn indefinite wait is indicated.
=0DA check for completion is specified. AWAITIO[X] immediately
returns to the caller, regardless of whether or not an I/O completion
occurs.
<-1DFile-system error 590 occurs.
omitted An indefinite wait is indicated.