Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-3
WAIT^FILE Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
If abort-on-error mode is in effect, the only possible values for
error are:
0 No error
1 End of file
6 System message (only if user requested system messages through
SET^SYSTEMMESSAGES or SET^SYSTEMMESSAGESMANY)
40 Operation timed out (only if
time-limit is supplied and is not -1D)
111 Operation aborts because of BREAK (if BREAK is enabled)
532 Operation restarted
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.
time-limit input
INT(32):value
if present, indicates whether the caller waits for completion or checks for
completion. If omitted, the time limit is set to -1D.
time-limit <> 0D indicates a wait for completion. The time limit then
specifies the maximum time, in 0.01-second units, the
caller waits for a completion.
0D indicates a check for completion. WAIT^FILE
immediately returns to the caller regardless of whether
error := WAIT^FILE ( file-fcb ! i
,[ count-read ] ! o
,[ time-limit ] ); ! i