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

入力引数

すべて折りたたむ

`t` — タスク
`parallel.Task` オブジェクト

タスク。parallel.Task オブジェクトとして指定します。

`j` — ジョブ
`parallel.Job` オブジェクト

ジョブ。parallel.Job オブジェクトとして指定します。

バージョン履歴

R2006a より前に導入

参考

cancelAll | delete | submit