parallel.Task

タスクのプロパティおよび動作にアクセスする

コンストラクター

getCurrentTask (MATLAB ワーカーのワークスペース内)

親	parallel.Job
子	なし

parallel.Task オブジェクトは、ジョブの一部としてワーカーで実行されるタスクへのアクセスを提供します。

以下の表では、クラスターのタイプに応じて使用可能となるタスクオブジェクトのタイプについて説明します。

タスクタイプ	説明
parallel.task.MJSTask	MATLAB^® ジョブスケジューラクラスター上のタスク
parallel.task.CJSTask	CJS クラスター上のタスク

どのタスクタイプオブジェクトにも、以下の表で説明される同じメソッドがあります。

cancel	Cancel job or task
delete	Remove job or task object from cluster and memory

以下のプロパティはすべてのタスクオブジェクトタイプに共通です。

プロパティ	説明
`CaptureDiary`	diary の出力を返すかどうかを指定
`CreateDateTime`	タスクの作成日時
`Diary`	タスクオブジェクトの関数の実行により生成されるテキスト
`Error`	タスクエラー情報
`ErrorIdentifier`	タスクエラー識別子
`ErrorMessage`	タスクエラーのメッセージ
`FinishDateTime`	タスクの完了日時
`Function`	タスクを評価するときに呼び出される関数
`ID`	タスクの数値識別子
`InputArguments`	タスク関数への入力引数
`Name`	このタスクの名前
`NumOutputArguments`	タスク関数によって返される引数の数
`OutputArguments`	ワーカーで実行されるタスク関数の出力引数
`Parent`	このタスクが含まれているジョブオブジェクト
`RunningDuration`	タスクの現在の継続時間。`duration` オブジェクトとして指定します。
`StartDateTime`	タスクの開始日時
`State`	タスクの現在の状態
`UserData`	このタスクオブジェクトに関連付けられている情報
`Warnings`	タスクの実行中に発行される警告情報。フィールド `message`、`identifier` および `stack` をもつ struct 配列内で取得されます
`Worker`	このタスクを実行したワーカーを表すオブジェクト

MATLAB ジョブスケジューラタスクオブジェクトには、共通のプロパティに加えて以下のプロパティがあります。

プロパティ	説明
`FailureInfo`	失敗したタスクから返される情報
`FinishedFcn`	タスクが完了したときにクライアントで実行されるコールバック
`MaximumRetries`	失敗したタスクを再実行する回数の上限
`NumFailures`	タスクが失敗した回数
`RunningFcn`	タスクが実行を開始したときにクライアントで実行されるコールバック
`Timeout`	タスクを完了するための制限時間 (秒単位)

CJS タスクオブジェクトには、共通のプロパティに加えて以下のプロパティがあります。

プロパティ	説明
`SchedulerID`	タスクをサードパーティ製スケジューラに送信した場合、送信時にこの ID がスケジューラによってタスクに割り当てられます。たとえば、SLURM スケジューラではこれは `JOBID` に対応します。

どの種類の parallel.Task オブジェクトでも、ヘルプ (各プロパティのヘルプへのリンク一覧など) を表示するには、以下のように入力します。

help parallel.task.MJSTask
help parallel.task.CJSTask

R2012a で導入