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