cancel

Cancel job or task

Syntax

cancel(t)

cancel(j)

Description

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.

example

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 a MATLAB^® Job Scheduler, 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.

Examples

collapse all

Cancel Tasks

Cancel a task. Note afterward the task's State and Error 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
        StartDateTime: 
     RunningDuration: 0 days 0h 0m 0s

                Error: The task was cancelled by user "mylogin" on machine "myhost.mydomain.com".
             Warnings: none

Input Arguments

collapse all

`t` — Task
`parallel.Task` object

Task, specified as a parallel.Task object.

`j` — Job
`parallel.Job` object

Job, specified as a parallel.Job object.

Version History

Introduced before R2006a