findJob

クラスター内のジョブ オブジェクトの検索

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

    構文

    objArray = findJob(cluster)
    objArray = findJob(cluster,propertyName=Value)
    [pending,queued,running,completed] = findJob(___)

    説明

    objArray = findJob(cluster) は、クラスター cluster 内のすべてのジョブ オブジェクトからなる配列を返します。配列内のジョブは、ジョブの作成順を示す ID プロパティの順序となっています。

    例

    objArray = findJob(cluster,propertyName=Value) は、1 つ以上のプロパティ名と値の引数を使用して、検索するプロパティと値を指定します。ジョブ プロパティのリストについては、parallel.Job を参照してください。

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

    例

    [pending,queued,running,completed] = findJob(___) は、クラスターに保存されているすべてのジョブ オブジェクトを状態別に並べ替えます。ジョブ配列 pending、running、completed 内では、ID プロパティの順序でジョブが返されます。ジョブ配列 queued 内のジョブはスケジューラでキューに入れられた順に整序されており、queued(1) に対応するジョブが次に実行されます。完了したジョブには、失敗したジョブも含まれます。この関数では、削除されたジョブやステータスが利用不可であるジョブは返されません。

    例

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    既定のプロファイルを使用してクラスターを作成し、batchを使用してランダムな数のジョブをクラスターに投入します。

    myCluster = parcluster;
numJobs = randi(50);
for idx = 1:numJobs
    job = batch(myCluster,@magic,1,{idx});
end

    クラスターに投入したジョブの数を求めます。 

    objArray = findJob(myCluster);
whos objArray
      Name           Size            Bytes  Class                             Attributes

  objArray      10x1                80  parallel.job.CJSIndependentJob

    クラスターに投入したジョブの State プロパティを特定します。

    [pending,queued,running,completed] = findJob(myCluster);

    completed 状態のジョブの ID プロパティをリストします。 

    completed.ID
    ans = 120

    ans = 121

    ans = 122

    ans = 123
    ライブ スクリプトを開く

    既定のプロファイルを使用してクラスターを作成し、createJobを使用してジョブをクラスターに投入します。

    myCluster = parcluster;
job1 = createJob(myCluster,Tag="testing");
job2 = createJob(myCluster,Name="MonteCarlo",Tag="testing");
job3 = createJob(myCluster,Name="MonteCarlo2",Tag="testing");

    Tag プロパティの値が testing であるジョブを検索します。

    objArray = findJob(myCluster,Tag="testing");
objArray.Name
    ans = 
'Job23'

    ans = 
'MonteCarlo'

    ans = 
'MonteCarlo2'

    最後に、Name プロパティの値 MonteCarlo の形式でもう 1 つの検索条件を追加して、Tag プロパティの値 testing をもつジョブのリストを絞り込みます。

    objArray = findJob(myCluster,Name="MonteCarlo",Tag="testing");
objArray.Name
    ans = 
'MonteCarlo'

    入力引数

    すべて折りたたむ

    ジョブの検索先となるクラスター。クラスター計算リソースを表す parallel.Cluster オブジェクトとして指定します。クラスター オブジェクトを作成するには、関数 parcluster を使用します。

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

    例: findJob(cluster,Username="jsmith") は、Username プロパティの値が jsmith であるジョブ オブジェクトを検索します。

    出力引数

    すべて折りたたむ

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

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

    クラスターで待機状態のジョブ。parallel.Job オブジェクトの配列として返されます。

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

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

    バージョン履歴

    R2006a より前に導入

    参考

    |