次の方法で共有

ジョブとタスクのプロパティについて

  • [アーティクル]

次の表に、HPC ジョブ マネージャーで設定できるすべてのジョブとタスクのプロパティの一覧を示します。 これらのプロパティは、ジョブとタスクの実行方法を定義します。

手記

ジョブ テンプレートは、さまざまな種類のジョブに対してクラスター管理者によって作成されます。 ジョブ テンプレートは、ジョブ プロパティの既定値と制約を定義します。 ジョブに対して選択するジョブ テンプレートによっては、ジョブのプロパティで使用可能な値に違いがある場合があります。 たとえば、1 つのテンプレートで Priority 値の全範囲を許可し、別のテンプレートでは標準 以下の値のみを許可 場合があります。

このトピックでは、次の操作を行います。

ジョブのプロパティ

Job プロパティ 形容
ジョブ ID ジョブの数値 ID。 ジョブ スケジューラは、ジョブの作成時にこの番号を割り当てます。
ジョブ名 ジョブのユーザー割り当て名。 このプロパティの最大長は 128 文字です。
ジョブ テンプレート ジョブの送信に使用されるジョブ テンプレートの名前。 ジョブを作成すると、ジョブ テンプレート ドロップダウン リストに使用可能なテンプレートが表示されます。 ジョブ テンプレートは、さまざまな種類のジョブに対してクラスター管理者によって作成されます。 ジョブ テンプレートは、ジョブ プロパティの既定値と制約を定義します。 新しいジョブのジョブ テンプレートを選択すると、[新しいジョブ] ダイアログ ボックスのジョブ プロパティで使用可能な値が適宜変更されます。 たとえば、[優先度] ドロップダウン メニューには、選択したテンプレートで有効な優先度レベルのみが表示され、実行時設定を定義された最大値を超えることはできません。 詳細については、「ジョブ テンプレートについて - ジョブ マネージャー」を参照してください。 注: クラスター管理者は、特定のジョブ テンプレートを使用できるユーザーに関するアクセス許可を指定できます。 アクセス権を持ち、使用する必要があるジョブ テンプレートの詳細については、クラスター管理者に問い合わせてください。
プロジェクト ジョブが属するプロジェクトの名前。 このプロパティの最大長は 128 文字です。

場合によっては、クラスター管理者が特定のジョブ テンプレートのプロジェクト名の一覧を定義することがあります。 選択したジョブ テンプレートにプロジェクト名の一覧が含まれている場合、その名前は Project ドロップダウン リストに表示されます。
優先権 ジョブの優先順位。 優先順位と送信時間は、ジョブを実行するタイミングと、ジョブが取得するリソースの数を決定するのに役立ちます。 優先度は、優先度バンド、優先度番号、または 2 つの組み合わせで指定できます。 優先度バンドとそれに対応する数値は次のとおりです。

- 最低 (0)
- BelowNormal (1000)
- Normal (2000)
- AboveNormal (3000)
- 最高 (4000)

数値の優先順位には、0 (最下位) から 4000 (最高) までの値を指定できます。 数値を入力すると、対応する優先度バンドまたは組み合わせとして表示されます。 たとえば、値 2500 を指定すると、優先度は Normal+500として表示されます。 注: 優先度バンドでジョブをフィルター処理する場合、バンドの数値は範囲の中央として扱われます。 このフィルターは、バンド値から 499 を引いた値とバンド値に 500 を加算した優先順位を持つジョブを返します。 たとえば、ジョブ リストをフィルター処理して、標準 優先度のジョブ 表示すると、1501 から 2500 までの数値の優先順位を持つジョブが返されます。 この動作は、HPC API を使用してジョブ 一覧をフィルター処理するときに変更されます。 HPC API を使用して優先度バンドでジョブをフィルター処理する場合、バンド値は範囲の先頭として扱われます。 このフィルターは、バンド値とバンド値に 999 を加えた優先順位を持つジョブを返します。 たとえば、フィルターを filter.Add(FilterOperator.Equal, PropId.Job_Priority, JobPriority.Normal);として定義した場合、フィルターは 2000 年から 2999 年までの数値の優先順位を持つジョブを返します。
実行時 ジョブの実行が許可されている時間 (dd:hh:mm)。 指定した実行時間に達した後もタスクが実行されている場合は、ジョブ スケジューラによって自動的に取り消されます。

ジョブの合計ランタイムには、ノード準備、ノード リリース、プライマリ タスクが含まれます。 詳細については、「タスクの種類について - ジョブ マネージャー」を参照してください。

ジョブに最大実行時間があり、ノード リリース タスクがある場合、ジョブ スケジューラはジョブの実行時間が経過する前にジョブ内の他のタスクを取り消します (ジョブの実行時間からノード リリース タスクの実行時間 差し引いた値)。 これにより、ノード リリース タスクは、ジョブに割り当てられた時間内に実行できます。
取り消されるまで実行する true場合、ジョブは取り消されるまで、または実行時間が経過するまで実行されます。 タスクが残っていない場合は停止しません。
タスクの失敗時に失敗する true場合、ジョブ内のタスクが失敗すると、ジョブ全体が直ちに失敗します。
開始時に通知する true場合は、ジョブの開始時に電子メールまたはその他の通知を受け取ることができます。 クラスター管理者がクラスターで通知を有効にする必要があります。
完了時に通知する true場合は、ジョブの完了時に電子メールまたはその他の通知を受け取ることができます。 クラスター管理者がクラスターで通知を有効にする必要があります。
コア数 ジョブに必要なコアの数。 最小値と最大値を設定するか、[自動計算 選択して、ジョブスケジューラがジョブのタスクに基づいて必要なコアの最小数と最大数を自動的に計算するようにします。
ソケットの数 ジョブに必要なソケットの数。 最小値と最大値を設定するか、[自動計算 を選択して、ジョブ スケジューラがジョブのタスクに基づいて必要なソケットの最小数と最大数を自動的に計算するようにします。
ノードの数 ジョブに必要なノードの数。 最小値と最大値を設定するか、 自動計算 選択して、ジョブスケジューラがジョブのタスクに基づいて必要なノードの最小数と最大数を自動的に計算するようにします。
排他的 true場合、このジョブと同時にコンピューティング ノードで他のジョブを実行することはできません。
ノードの基本設定 (ノード グループ演算子) ジョブ スケジューラがノード グループを使用してジョブにリソースを割り当てる方法。 次の環境設定を使用できます。

- 次のすべてのグループ (交差) - のメンバーであるノードでのみ実行します。
ジョブは、リスト内のすべてのノード グループに属するノードでのみ実行する必要があります。 たとえば、少なくとも 4 ギガバイト (GB) のメモリを持つノードのノード グループと、少なくとも 8 つのコアを持つノードの別のノード グループがある場合は、それらのノード グループと、少なくとも 4 GB のメモリと少なくとも 8 コアのノードでアプリケーションを実行するように、この優先設定を指定します。
- 次のいずれかのノード グループ (Uniform) のメンバーであるノードで実行 - ジョブは、リスト内の任意の 1 つのノード グループに属するノードでのみ実行する必要があります。 たとえば、この設定は、オンプレミスのコンピューティング ノードと Windows Azure ノードを含むハイブリッド クラスターに役立ちます。 どちらの環境でもアプリケーションを実行できますが、アプリケーションがオンプレミスと Windows Azure の両方のノードにまたがるのを同時に許可しないようにすることができます。
- 次のグループ (共用体) のいずれかのメンバーであるノードで実行 - ジョブは、リスト内の任意のノード グループに属するノードで実行できます。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。
1 つのノードで実行する true場合は、ノードのすべてのコアを予約せずに、1 つのノードでジョブを実行します。 たとえば、このジョブは最低 2 コア、最大 4 コアで実行する必要がありますが、1 つのノードで実行する必要があることを指定できます。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。
ノード グループ このジョブの候補リソースを定義するのに役立つノード グループの一覧。 HPC Pack 2008 R2 では、ジョブは一覧表示されているすべてのグループのメンバーであるノードでのみ実行できます。 たとえば、"Have Application X" と "Have Big Memory" のグループを一覧表示する場合、ノードは両方のグループに属している必要があります。 [新しいジョブ] ダイアログ ボックスで、1 つ以上のノード グループを選択すると、ノード選択リストで使用できるノードがフィルター処理されます。 一覧にノードが表示されない場合は、指定されたすべてのグループに属するノードがないことを意味します。

HPC Pack 2012 では、ノード設定によって、ノード グループ内のノードのすべてまたはサブセットがジョブの候補リソースであるかどうかを決定します。

ジョブの実行に使用できる既定のノード グループを次に示します。

コンピューティング ノード の
- ワークステーション ノードの
- AzureNodes (HPC Pack 2008 R2 Service Pack 1 (SP1) で導入)
- UnmanagedServerNodes (HPC Pack 2008 R2 Service Pack 3 (SP3) で導入)

クラスター管理者は、追加のカスタム ノード グループを作成し、ノードを 1 つ以上のグループに割り当てることができます。 クラスター管理者は、ノード グループのメンバーシップをいつでも変更できます。これは、使用可能なリソースに影響を与える可能性があります。 指定したノード グループに属しなくなったノードでタスクが実行されている場合、タスクは取り消されます。 ジョブの実行に必要な最小限のリソースがなくなった場合は、ジョブが再キューされます。
要求されたノード ノードの一覧。 ジョブは、このリスト内のノードでのみ実行できます。
記憶 ジョブが実行されるすべてのノードに存在する必要があるメモリの最小量 (MB 単位)。
ノードあたりのコア数 ジョブが実行されるすべてのノードに存在する必要があるコアの最小数。
ノードの順序付け ジョブのノードを選択するときに使用する順序。 このプロパティは、使用可能なメモリまたはコア リソースに基づいてノードを優先します。 値のオプションは次のとおりです。

- その他のメモリ
- メモリ の削減
その他のコア を する
- コア数の を減らします
ライセンス ジョブに必要なライセンスの一覧。 この一覧の値は、クラスター管理者によって定義されたジョブアクティブ化フィルターによって検証できます。
環境変数 ジョブのすべてのタスクのコンテキストで設定される環境変数の名前と値のペアの一覧。 名前の最大長は 128 文字です。 値の最大長はありません。

同じ環境変数に異なる値が設定されている場合、環境変数階層によって、タスクのコンテキストで使用される値が決まります。 たとえば、%TMP% がジョブおよびタスク変数として設定されている場合、タスク変数の値は、その特定のタスクのコンテキストで優先されます。

クラスターで実行されているタスクに使用される階層は次のとおりです。

1. タスク
2. ジョブ
3. クラスター全体
4. ユーザー
5. システム
終了コード タスクが正常に完了したことを示す 1 つ以上の数値コードの一覧。 リストが指定されていない場合、成功を示す唯一のタスク終了コードは 0 です。 指定した場合、成功終了コードのリストは、タスク自体に別の値を指定してそのリストをオーバーライドしない限り、ジョブ内のすべてのタスクに適用されます。 注: 既定のジョブ成功終了コードは 0。 このフィールドをクリアすると、終了コードは 0 (既定値) に設定されます。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。
ジョブに依存 ジョブの実行を開始する前に完了する必要があるジョブの一覧 (ID 別)。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。
次の時間までジョブを保留 ジョブがキューに登録されている日付と時刻。 任意のユーザーがこのプロパティを設定でき、ジョブの実行を開始する前にいつでも変更できます。 重要: ジョブが実行されると、 プロパティがクリアされるまでジョブ 保留になります。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。
プロセスあたりの推定メモリ数 ジョブ内のプロセスが消費するメモリの最大量 (MB 単位) の見積もり。 ジョブ スケジューラは、少なくとも指定されたメモリ量を持つノードでジョブを実行することのみを考慮します。

ジョブのテンプレートに指定された値の範囲内にある値を選択できます。 値 0 (有効な場合) は、ジョブ スケジューラがジョブのメモリ要件に基づいてノードにジョブを割り当てないことを示します。

詳細については、「Memory-Aware スケジュールの設定 - ジョブ マネージャー」を参照してください。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。

HPC Power Shell を使用するか、コマンド プロンプト ウィンドウで、いくつかの追加のジョブ プロパティを設定できます。 たとえば、ジョブから除外するノードを指定したり、ジョブの進行状況または進行状況メッセージを手動で設定したりできます。 HPC ジョブ マネージャーでこれらのプロパティを設定することはできませんが、対応する列を表示することで、それらの値をジョブ 一覧に表示できます。 詳細については、「ジョブの除外ノードの定義 - ジョブ マネージャー」および「スクリプト ファイル - ジョブ マネージャー からの進行状況と進行状況メッセージ ジョブのプロパティの設定」を参照してください。

タスクのプロパティ

Task プロパティ 形容
タスク ID タスクの数値 ID。 ジョブ スケジューラは、タスクの作成時にこの番号を割り当てます。
タスク名 タスクのユーザー割り当て名。 このプロパティの最大長は 128 文字です。
種類 コマンドの実行方法を定義するのに役立ちます。 タスク タイプ の既定値は、Basicです。 Basic タスクは、コマンドを 1 回実行します。 他の種類のタスクでは、それぞれがコマンドのインスタンスを実行するサブタスクが作成されます。 タスクには、最大 1,000,000 個のサブタスクを含めることができます。 詳細については、「タスクの種類について - ジョブ マネージャー」を参照してください。

型 には、次の値を指定できます。

- Basic
パラメトリック スイープ を する
- ノード準備
- ノード リリース
- サービス
コマンドライン タスクに対して実行されるコマンド。 実行可能ファイルへのパスは、タスクの作業ディレクトリに対する相対パスです。 詳細については、「アプリケーションファイルとデータ ファイルについて - ジョブ マネージャー」を参照してください。

Microsoft® Message Passing Interface (MS-MPI) を介して並列タスクを操作するジョブでは、mpiexec コマンドを使用する必要があるため、並列タスクのコマンドは次の形式にする必要があります。 mpiexec [mpi_options] <myapp.exe> [arguments]。ここで、myapp.exe は実行するアプリケーションの名前です。

サブタスクを含むタスクでは、パラメトリックスイープインデックス(パラメトリックスイープ タスク)またはサブタスクID(サービス、ノード準備、ノードリリース タスク)のプレースホルダーとしてアスタリスク(*) 文字を使用できます。 たとえば、最初のサブタスクでは、echo * は echo 1 として解釈されます (または、パラメトリック スイープ タスクでは、最初のインデックス値として解釈されます)。

複数のアスタリスク (*) を含めると、インデックスまたはサブタスクの数を表すときに使用する位置の最小数を示すことができます。 これにより、より多くのポジションを必要とする数値は制限されません。 たとえば、echo **** は最初のサブタスクで echo 0001 として解釈されます。

アスタリスク (*) を使用するコマンドを実行するには、キャレット (^) をエスケープ文字として含めます。 たとえば、フォルダーからすべてのファイルを削除する Node Release タスクを作成するには、次のようなコマンドを使用できます。

delete c:\temp\^*
作業ディレクトリ タスクの実行中に使用する作業ディレクトリ。 サブタスクを含むタスクでは、パラメトリックスイープインデックス(パラメトリックスイープ タスク)またはサブタスクID(サービス、ノード準備、ノードリリース タスク)のプレースホルダーとしてアスタリスク(*) 文字を使用できます。 詳細については、「アプリケーションファイルとデータ ファイルについて - ジョブ マネージャー」を参照してください。
標準入力 タスクの入力の読み取り元となるファイルへのパス (タスクの作業ディレクトリを基準とした相対パス)。 このプロパティの最大長は 160 文字です。

サブタスクを含むタスクでは、パラメトリックスイープインデックス(パラメトリックスイープ タスク)またはサブタスクID(サービス、ノード準備、ノードリリース タスク)のプレースホルダーとしてアスタリスク(*) 文字を使用できます。 詳細については、「アプリケーションファイルとデータ ファイルについて - ジョブ マネージャー」を参照してください。
標準出力 タスクの出力の書き込み先となるファイルへのパス (タスクの作業ディレクトリを基準とする相対パス)。 このプロパティの最大長は 160 文字です。

サブタスクを含むタスクでは、パラメトリックスイープインデックス(パラメトリックスイープ タスク)またはサブタスクID(サービス、ノード準備、ノードリリース タスク)のプレースホルダーとしてアスタリスク(*) 文字を使用できます。 詳細については、「アプリケーションファイルとデータ ファイルについて - ジョブ マネージャー」を参照してください。

標準出力 と標準エラー が指定されていない場合、結果は HPC ジョブ スケジューラ サービス データベースに送られ、タスクの出力フィールドとエラー フィールドとして表示されます。 データベースには、タスクごとに最大 4,000 文字のデータが格納されます。 HPC Pack 2012 では、最新の 4,000 文字のデータが格納されます。 HPC Pack 2008 R2 では、最初の 4,000 文字を超える追加データは切り捨てられます。
標準エラー タスクのエラーを書き込むファイルへのパス (タスクの作業ディレクトリを基準とした相対パス)。 このプロパティの最大長は 160 文字です。

サブタスクを含むタスクでは、パラメトリックスイープインデックス(パラメトリックスイープ タスク)またはサブタスクID(サービス、ノード準備、ノードリリース タスク)のプレースホルダーとしてアスタリスク(*) 文字を使用できます。 詳細については、「アプリケーションファイルとデータ ファイルについて - ジョブ マネージャー」を参照してください。

標準出力 と標準エラー が指定されていない場合、結果は HPC ジョブ スケジューラ サービス データベースに送られ、タスクの出力フィールドとエラー フィールドとして表示されます。 データベースには、タスクごとに最大 4,000 文字のデータが格納されます。 HPC Pack 2012 では、最新の 4,000 文字のデータが格納されます。 HPC Pack 2008 R2 では、最初の 4,000 文字を超える追加データは切り捨てられます。
コア数 タスクに必要なコアの数。 このプロパティの最小値と最大値を設定できます。
排他的 true場合、そのタスクと同時にコンピューティング ノードで他のタスクを実行することはできません。
再実行可能 true場合、タスクが割り込まれた場合、またはノードに到達不能になったなどのクラスターの問題が原因で失敗した場合、ジョブ スケジューラはタスクの再実行を試みることができます。 [再実行可能な が False場合、最初の実行の試行が失敗した後にタスクが失敗します。 注: ジョブ スケジューラは、完了するまで実行されるタスクの再実行を試みず、失敗を示す終了コード (既定では 0 以外の終了コード) を返します。 HPC Pack 2012 では、成功エラー コードは、個々のタスクまたはジョブ内のすべてのタスクに対して定義できます。
実行時 タスクの実行が許可されている時間 (dd:hh:mm)。 指定した実行時間に達した後もタスクが実行されている場合は、ジョブ スケジューラによって自動的に取り消されます。
環境変数 タスクの実行時環境で設定する環境変数を指定します。 環境変数は、name1=value1の形式でコンマで区切る必要があります。 名前の最大長は 128 文字です。 値の最大長はありません。

ジョブ レベルで環境変数を設定することもできます。 ジョブ レベルの環境変数は、ジョブのすべてのタスクのコンテキストで設定されます。

同じ環境変数に異なる値が設定されている場合、環境変数階層によって、タスクのコンテキストで使用される値が決まります。 たとえば、%TMP% がジョブおよびタスク変数として設定されている場合、タスク変数の値は、その特定のタスクのコンテキストで優先されます。
必要なノード タスクを実行するためにタスクとそのジョブに割り当てる必要があるノードを一覧表示します。
スイープ開始インデックス* パラメトリック スイープ タスクの開始インデックス。 インデックスは、アプリケーションのインスタンス、作業ディレクトリ、入力、出力、エラー ファイル (指定されている場合) に適用できます。 インデックスを適用するには、コマンド ラインとファイル名にアスタリスク (*) を含める必要があります。 たとえば、myTask.exe *、myInput*.datなどです。
スイープ終了インデックス* パラメトリック スイープ タスクの終了インデックス。 インデックスは、アプリケーションのインスタンス、作業ディレクトリ、入力、出力、エラー ファイル (指定されている場合) に適用できます。 インデックスを適用するには、コマンド ラインとファイル名にアスタリスク (*) を含める必要があります。 たとえば、myTask.exe *、myInput*.datなどです。
スイープ増分 スイープの各ステップでパラメトリック スイープ インデックスをインクリメントする量。 インデックスは、アプリケーションのインスタンス、作業ディレクトリ、入力、出力、エラー ファイル (指定されている場合) に適用できます。 インデックスを適用するには、コマンド ラインとファイル名にアスタリスク (*) を含める必要があります。 たとえば、myTask.exe *、myInput*.datなどです。
タスクに依存 タスクを実行する順序を定義するグループに割り当てられた、ID によるタスクの一覧。 詳細については、「タスクの依存関係の定義 - ジョブ マネージャーの」を参照してください。
タスク終了コード タスクが正常に完了したことを示す 1 つ以上の数値コードの一覧。 リストが指定されていない場合は、0 だけがタスク終了コードです。 注: このプロパティは HPC Pack 2012 で導入されました。 以前のバージョンでは使用できません。

その他の参照