Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_AWAITIO64_)
error := FILE_AWAITIO64_ ( filenum ! i, o
,[ buffer-addr ] ! o
,[ count-transferred ] ! o
,[ tag ] ! o
,[ timelimit ] ! i
,[ segment-id ] ); ! o
Parameters
filenum
input, output
INT .EXT64:ref:1
is the number of an open file. If a particular filenum is passed, FILE_AWAITIO64_ applies
to that file.
If filenum is passed as -1, the call to FILE_AWAITIO64_ 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).
FILE_AWAITIO64_ returns into filenum the file number associated with the completed
operation.
buffer-addr
output
EXT64ADDR:EXT64:ref:1
returns the 64-bit address of the buffer specified when the operation is initiated.
If the actual parameter is used as an address pointer to the returned data and is declared in
the form INT. EXT64 buffer-addr, it must be passed to FILE_AWAITIO64_ in the form
@buffer-addr.
count-transferred
output
INT(32) .EXT64:ref:1
returns the count of the number of bytes transferred because of the associated operation.
tag
output
INT(64) .EXT64:ref:1
returns the application-defined tag that is stored by the system when the I/O operation
associated with this completion was initiated. The value of the 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
tags is the signed-extended value of the 32-bit tag.
354 Guardian Procedure Calls (F)