Guardian Procedure Calls Reference Manual

WAIT^FILE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The WAIT^FILE procedure is used to wait or check for the completion of an outstanding I/O
operation.
WAIT^FILE is a sequential I/O (SIO) procedure and should be used only with files that have been
opened by OPEN^FILE.
Syntax for C Programmers
#include <cextdecs(WAIT_FILE)>
short WAIT_FILE ( short _near *file-fcb
,[ short _near *count-read ]
,[ __int32_t time-limit ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := WAIT^FILE ( file-fcb ! i
,[ count-read ] ! o
,[ time-limit ] ); ! i
Parameters
file-fcb
input
INT:ref:*
identifies the file for which there is an outstanding I/O operation.
count-read
output
INT:ref*
if present, is the count of the number of bytes returned due to the requested read operation.
The value returned to the parameter has no meaning when waiting for a write operation to
complete.
1488 Guardian Procedure Calls (W-Z)