Guardian Procedure Calls Reference Manual

FILE_AWAITIO64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Operation and Completion Summary
Considerations
OSS Considerations
Related Programming Manual
Summary
The FILE_AWAITIO64_ procedure is used to complete a previously initiated I/O operation.
Use FILE_AWAITIO64_ to:
• Wait for the operation to complete on:
A particular file—Application process execution suspends until the completion occurs. A
timeout is considered to be a completion in this case.
◦
◦ Any file or for a timeout to occur—A timeout is not considered a completion in this case.
• Check for the operation to complete on:
A particular file—The call to FILE_AWAITIO64_ immediately returns to the application
process, regardless of whether there is a completion or not. (If there is no completion, an
error indication is returned.)
◦
◦ Any file
FILE_AWAITIO64_ extends the capabilities of AWAITIOXL in the following ways:
• It permits the read/write buffer to reside outside the 32-bit addressable range.
• It is callable from both 32-bit and 64-bit processes.
• It allows the returned count-transferred, tag and segment-id arguments to reside
outside the 32-bit addressable range
• Rather than returning a condition code status, the procedure returns a file management error.
A return value of zero indicates success.
If FILE_AWAITIO64_ is used to wait for a completion, you can specify a time limit.
NOTE: The FILE_AWAITIO64_ procedure is supported on systems running H06.24 and later
H-series RVUs and J06.13 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <cextdecs(FILE_AWAITIO64_)>
short FILE_AWAITIO64_ ( short _ptr64 *filenum
,[ long long _ptr64 *buffer-addr ]
,[__int32_t _ptr64 *count-transferred ]
,[ long long _ptr64 *tag ]
,[ __int32_t timelimit ]
,[ short _ptr64 *segment-id ] );
FILE_AWAITIO64_ Procedure 353