wait

Wait for job to change state

Syntax

wait(j)
wait(j,state)
OK = 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.

OK = wait(j,state,timeout) blocks execution until either the job reaches the specified state, or timeout seconds elapse, whichever happens first. OK is false if timeout is exceeded before state is reached.

Note

Simulink® models cannot run while a MATLAB® session is blocked by wait. If you must run Simulink from the MATLAB client while also running jobs, you cannot use wait.

Examples

Submit a job to the queue, and wait for it to finish running before retrieving its results.

submit(j);
wait(j,'finished')
results = fetchOutputs(j)

Submit a batch job and wait for it to finish before retrieving its variables.

j = batch('myScript');
wait(j)
load(j)
Introduced in R2008a