cancel

取消作业或任务

语法

cancel(t)

cancel(j)

说明

cancel(t) 停止当前处于待处理或运行状态的任务对象 t。该任务的 State 属性设置为 'finished'，并且没有返回任何输出参量。一条表明任务已取消的错误消息被放置在任务对象的 ErrorMessage 属性中，并且运行该任务的工作进程会话将重新启动。

示例

cancel(j) 停止待处理、排队或正在运行的作业对象 j。该作业的 State 属性设置为 'finished'，并对作业中所有未处于 'finished' 状态的任务执行取消。已取消的作业对象无法重新启动。

如果该作业是从 MATLAB^® 作业调度器运行的，则正在评估属于该作业对象的任务的任何工作进程会话都将重新启动。

如果指定的作业或任务已经处于 'finished' 状态，则不采取任何操作。

示例

全部折叠

取消任务

取消任务。随后注意任务的 State 和 Error 属性。

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