User`s guide

11 Functions — Alphabetical List
11-300
wait
Wait for job to change state
Syntax
wait(j)
wait(j,'state')
wait(j,'state',timeout)
Arguments
j Job object whose change in state to wait for.
'state' Value of the job object’s State property to wait for.
timeout Maximum time to wait, in seconds.
Description
wait(j) blocks execution in the client session until the job identified by the object j
reaches the 'finished' state or fails. This occurs when all the job’s tasks are finished
processing on the workers.
wait(j,'state') blocks execution in the client session until the specified job object
changes state to the value of 'state'. The valid states to wait for are 'queued',
'running', and 'finished'.
If the object is currently or has already been in the specified state, a wait is
not performed and execution returns immediately. For example, if you execute
wait(j,'queued') for a job already in the 'finished' state, the call returns
immediately.
wait(j,'state',timeout) blocks execution until either the job reaches the specified
'state', or timeout seconds elapse, whichever happens first.