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

    入力引数

    すべて折りたたむ

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

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

    バージョン履歴

    R2006a より前に導入

    参考

    | |