Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

findJob

クラスターに保存されているジョブ オブジェクトを検索する

    説明

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

    objArray = findJob(cluster,propertyName,propertyValue) は、プロパティ propertyName とその値 propertyValue をもつジョブ オブジェクトからなる配列 objArray を返します。ジョブ プロパティの一覧については、parallel.Job を参照してください。

    一致と認められるには、オブジェクト プロパティの値が、大文字と小文字の区別も含めて、指定された値と厳密に同じでなければなりません。たとえば、ジョブの Name プロパティの値が MyJob の場合、Name プロパティの値 myjob を検索しても、findJob はこのオブジェクトを検出しません。

    objArray = findJob(cluster,propertyName1,propertyValue1,...,propertyNameN,propertyValueN) は、検索条件のすべてのプロパティ名とプロパティ値を満たすジョブ オブジェクトからなる配列 objArray を返します。

    [pending,queued,running,completed] = findJob(objArray,___) は、クラスター c に保存されているすべてのジョブ オブジェクトを状態別に並べ替えます。pendingrunning および completed 内では、ジョブは作成順に返されます。配列 queued 内のジョブはキューに入った順に整序されており、queued(1) の位置にあるジョブが次に実行されます。completed 状態のジョブには、失敗したジョブも含まれます。この関数では、削除されたジョブやステータスが利用不可であるジョブは返されません。

    すべて折りたたむ

    既定のプロファイルを使用してクラスターを作成し、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 = 
    'Job142'
    
    ans = 
    'MonteCarlo'
    
    ans = 
    'MonteCarlo2'
    

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

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

    入力引数

    すべて折りたたむ

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

    例: cluster = parcluster; findJob(cluster);

    データ型: parallel.Cluster

    検索するジョブ オブジェクトのプロパティ名。string スカラーまたは文字ベクトルとして指定します。複数の名前と値のペアを指定した場合、返されるエントリはすべての条件を満たしています。ジョブ オブジェクトのプロパティの完全な一覧については、parallel.Job を参照してください。

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

    データ型: char | string

    検索するジョブ オブジェクトのプロパティ値。string スカラーまたは文字ベクトルとして指定します。複数の適切な名前とプロパティ値のペアを指定した場合、返されるエントリはすべての条件を満たしています。ジョブ オブジェクトのプロパティの完全な一覧については、parallel.Job を参照してください。

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

    データ型: char | string

    出力引数

    すべて折りたたむ

    クラスターで検出したジョブ。parallel.Job オブジェクトの配列として返されます。

    データ型: parallel.Job objects

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

    データ型: parallel.Job object

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

    データ型: parallel.Job object

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

    データ型: parallel.Job object

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

    データ型: parallel.Job object

    バージョン履歴

    R2006a より前に導入