Exchange/RJE Manual

AWAITIO Procedure
Exchange/RJE System Procedure Calls
104698 Tandem Computers Incorporated 5–7
AWAITIO Procedure The AWAITIO procedure completes (or checks for the completion of) a previously
initiated nowait I/O operation.
CALL AWAITIO ( filenum
, [ buffer-addr ]
, [ count-transferred ]
, [ tag ]
, [ time-limit ] );
filenum
INT:ref:1
is the file number of the Exchange/RJE line server. This number is returned by the
call to OPEN that established communication with the line server.
You can also specify a file number of -1, which indicates that AWAITIO can
complete an outstanding nowait I/O operation on any file. In this case, filenum
returns the file number of the file associated with the nowait I/O operation that
was completed by the call to AWAITIO. The tag parameter (see below) identifies
the particular nowait I/O operation that was completed.
buffer-addr
INT:ref:1
returns the address of the buffer specified when the operation was initiated. For a
receive operation (READ), the buffer contains the record received from the remote
system. For a send operation (WRITE), the buffer contains the record sent to the
remote system.
count-transferred
INT:ref:1
returns the number of bytes sent or received. For a receive operation (READ), this
is the size, in bytes, of the record received from the remote system and now in the
buffer specified by buffer-addr . For a send operation (WRITE), this is the size,
in bytes, of the record sent to the remote system.
tag
INT(32):ref:1
returns a unique, application-defined value that your program uses to identify a
particular I/O operation when performing nowait I/O. The value returned is the
value supplied by your program when the nowait I/O operation was initiated.
This parameter is required to identify individual I/O operations when a single file
can have two or more nowait I/O operations outstanding at the same time.