Guardian Procedure Calls Reference Manual

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. Possible values are:
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 there is a completion. If no completion occurs the I/O operation is still outstanding;
an error 40 and an "operation timed out" message are returned.
0D
indicates no completion. Therefore, READ^FILE or WRITE^FILE cannot be called for the file until
the operation completes by WAIT^FILE.
0D (and error=40)
indicates a willingness to wait forever.-1D
Returned Value
INT
Error code. If abort-on-error mode is in effect, the only possible values for error are:
No error.0
End of file.1
System message (only if user requested system messages through SET^SYSTEMMESSAGES or
SET^SYSTEMMESSAGESMANY).
6
Operation timed out (only if time-limit is supplied and is not -1D).40
Operation aborts because of BREAK (if BREAK is enabled).111
Operation restarted.532
Example
ERROR := WAIT^FILE ( IN^FILE , COUNT );
Related Programming Manual
For programming information about the WAIT^FILE procedure, see the Guardian Programmer's
Guide.
WAIT^FILE Procedure 1489