Cancel job or task
cancel(t)
cancel(j)
| Pending or running task to cancel. |
| Pending, running, or queued job to cancel. |
cancel(t) stops the task
object, t, that is currently in the pending or
running state. The task’s State property
is set to finished, and no output arguments are
returned. An error message stating that the task was canceled is placed
in the task object's ErrorMessage property, and
the worker session running the task is restarted.
cancel(j) stops the job object, j,
that is pending, queued, or running. The job’s State property
is set to finished, and a cancel is executed on
all tasks in the job that are not in the finished state.
A job object that has been canceled cannot be started again.
If the job is running from an MJS, any worker sessions that are evaluating tasks belonging to the job object are restarted.
If the specified job or task is already in the finished state,
no action is taken.
Cancel a task. Note afterward the task’s State, ErrorIdentifier,
and ErrorMessage properties.
c = parcluster();
job1 = createJob(c);
t = createTask(job1, @rand, 1, {3,3});
cancel(t)
t Task with properties:
ID: 1
State: finished
Function: @rand
Parent: Job 1
StartTime:
Running Duration: 0 days 0h 0m 0s
ErrorIdentifier: parallel:task:UserCancellation
ErrorMessage: The task was cancelled by user "mylogin" on machine
"myhost.mydomain.com".