findTask

ジョブ内のタスクの検索

ページ内をすべて折りたたむ

構文

tasks = findTask(j)
tasks = findTask(j,taskFcn)
[pending,running,completed] = findTask(j)
tasks = findTask(j,propertyName=Value)

説明

tasks = findTask(j) は、ジョブ j 内のタスク オブジェクトからなる 1 行 N 列の配列を返します。配列内のタスクは、タスクの作成順を示す ID プロパティの順序となっています。

例

tasks = findTask(j,taskFcn) は、taskFcn プロパティを使用してフィルターが適用された、ジョブ j 内のタスク オブジェクトの配列を返します。taskFcn は入力引数として j.Tasks プロパティを受け入れる関数ハンドルであり、返すタスクを示す logical 配列を返します。

[pending,running,completed] = findTask(j) は、ジョブ j に保存されているすべてのタスクを状態別に並べ替えます。pending,running,completed 配列内では、作成順でタスクが返されます。

tasks = findTask(j,propertyName=Value) は、1 つ以上のプロパティ名と値の引数を使用して、検索するプロパティと値を指定します。タスク プロパティのリストについては、parallel.Task を参照してください。

オブジェクト プロパティの値は、指定された値と厳密に一致しなければなりません。たとえば、タスクの Name プロパティ値が MyTask の場合、mytask という Name プロパティ値をもつタスクを検索しても、findTask はこのオブジェクトを検出しません。

例

すべて折りたたむ

既定のクラスター上にジョブ オブジェクトを作成します。

c = parcluster;
j = createJob(c);

タスクを作成し、ジョブ オブジェクトに追加します。

createTask(j,@rand,1,{10})

ジョブ j に追加されたすべてのタスク オブジェクトを検索します。

t = findTask(j)

入力引数

すべて折りたたむ

タスクが検索されるジョブ。parallel.Job オブジェクトとして指定します。

findTask でジョブ j のタスクへのフィルター適用に使用する関数。関数ハンドルとして指定します。

検索するタスク オブジェクトのプロパティ名と値。parallel.task プロパティの名前と値の引数として指定します。プロパティの名前と値の引数を複数指定した場合、findJob は、すべての検索条件を満たすエントリを返します。タスク オブジェクトのプロパティの完全な一覧については、parallel.Task を参照してください。

例: findTask(job,Name="jsmith") は、Name プロパティの値が jsmith であるタスク オブジェクトを検索します。

出力引数

すべて折りたたむ

検索条件を満たすジョブ内のタスク。parallel.Task オブジェクトの配列として返されます。

ジョブで保留状態のタスク。parallel.Task オブジェクトの配列として返されます。

ジョブで実行状態のタスク。parallel.Task オブジェクトの配列として返されます。

ジョブで完了状態または失敗状態のタスク。parallel.Task オブジェクトの配列として返されます。

ヒント

ジョブ j がリモート サービスに含まれる場合、findTask によりそのリモート サービスが呼び出されます。このため、取得されるタスクの数とネットワーク速度次第で、findTask の完了に長時間かかる可能性があります。また、リモート サービスが使用可能でなくなるとエラーがスローされます。

バージョン履歴

R2006a より前に導入

参考

| |