job submit
HPC クラスターで実行する指定されたジョブを送信します。
このコマンドの使用方法の例については、例を参照してください。
構文
job submit /id:<jobID> [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>]
[/holduntil:[{<DateTime>|<minutes>}]]
job submit /jobfile:<path>\<file_name> [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>] [/holduntil:[{<DateTime>|<minutes>}]]
job submit [/askednodes:<node_list>] [/corespernode:<min>[-<max>]]
[/customproperties:<property_list>] [/emailaddress:<address>]
[/estimatedprocessmemory:<memory>)] [/env:<variable_and_value_list>]
[/exclusive[:{true|false}]]
[/faildependenttasks[:{true|false}]] [/failontaskfailure[:{true|false}]]
[/holduntil:[{<DateTime>|<minutes>]] [/jobenv:<variable_and_value_list>]
[/jobname:<job_name>] [/jobtemplate:<job_template_name>]
[/license:<license_list>] [/memorypernode:<min>[-<max>]]
[/name:<task_name>] [/nodegroup:<node_group_list>] [/nodegroupop:{Intersect|Uniform|Union}]
[/notifyoncompletion[:{true|false}]] [/notifyonstart[:{true|false}]]
{[/numcores:<min>[-<max>]] | [/numnodes:<min>[-<max>]] |
[/numprocessors:<min>[-<max>]] | [/numsockets:<min>[-<max>]]}
[/orderby:<primary>[,<secondary>]] [/parametric:<index_specification>]
[/parentjobids:<jobID_list>] [/password:<password>]
[/priority:<priority>] [/progress:<percent_progress>]
[/progressmsg:<message>] [/projectname:<name>] [/requestednodes:<node_list>]
[/rerunnable:[{true|false}]] [/runtime:{<time> | Infinite}]
[/rununtilcanceled[:{true|false}]] [/singlenode[:{true|false}]] [/stderr:[<path>\]<file_name>]
[/stdin:[<path>\]<file_name>] [/stdout:[<path>\]<file_name>]
[taskexecutionretrylimit:<retry_limit>
[/type:<type_name>] [/workdir:<folder>] [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>] <command> [<arguments>]
[/validexitcodes:int|intStart..intEnd[,int|intStart..intEnd]*]
job submit {/? | /help}
パラメーター
パラメーター | 形容 |
---|---|
/id: jobID<> | 送信するジョブのジョブ識別子を指定します。 このパラメーターを使用して、既に存在し、タスクを含むジョブを送信します。 送信できるのは、構成状態のジョブのみです。 |
/jobfile:<パス>\<file_name> | 送信するジョブに使用する設定を含むジョブ XML ファイルのファイル名とパスを指定します。 このパラメーターを使用して、ジョブ XML ファイルの設定を含む新しいジョブを作成し、すぐに送信します。 |
/askednodes:<node_list> | 廃止。 代わりに、/requestednodes パラメーターを使用してください。 |
/corespernode:<min>[-<max>] | HPC ジョブ スケジューラ サービスがノードをジョブを実行する候補ノードと見なすためにノードに割り当てることができる最小コア数と、必要に応じて最大コア数を指定します。 このジョブは、最小値よりコア数が少ないノード、またはこのパラメーターが指定した最大値より多いノードでは実行されません。 クラスター内のすべてのノードに、このパラメーターに指定した範囲外のコアが多数ある場合、ジョブの送信時にエラーが発生します。 |
/customproperties:<property_list> |
<name1>=<value1>[;<name2>=<value2>..] の形式でジョブのカスタム プロパティを指定します。カスタム プロパティでは大文字と小文字が区別されず、最初に定義されたときに使用された大文字と小文字が反映されます。 このパラメーターは、1 つのタスク ジョブでのみ使用できます。それ以外の場合、プロパティは表示されません。 複数のタスクが必要な場合は、代わりに "job new" 操作でこのパラメーターを使用します。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/emailaddress:<address> | このジョブの通知をこのアドレスに送信します。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/env:<variable_and_value_list> | タスクの実行時環境で設定する環境変数の一覧と、それらの環境変数に割り当てる値を指定します。 リストの形式は、<variable_name1>=<value1> [;<variable_name2>=<value2>.] である必要があります。 または、複数の /env パラメーターを含めることで、複数の環境変数を設定することもできます。 それぞれは、<variable_name>=<値の形式を持つ異なる引数>必要があります。 環境変数の設定を解除するには、値を指定しないでください。 たとえば、=を <variable_to_unset_name>します。 |
/estimatedprocessmemory: メモリ<> | このジョブの各プロセスが消費すると推定されるメモリの最大量 (MB)。 |
/exclusive[:{true|false}] | HPC ジョブ スケジューラ サービスで、このジョブの実行中に、このジョブと同じノードで他のジョブが実行されないようにするかどうかを指定します。 値 True は、HPC ジョブ スケジューラ サービスで、このジョブの実行中に同じノードで他のジョブが実行されないようにする必要があることを示します。 False の値は、このジョブがコンピューティング ノードを他のジョブと共有できることを示します。 値を指定せずに /exclusive パラメーターを指定すると、ジョブ送信 コマンドは、値 true を指定したかのように動作します。 /exclusive パラメーターを指定しない場合、ジョブの送信 コマンドは False の値を指定した場合と同様に動作します。 |
/faildependenttasks[:{true|false}] | タスクが失敗した場合、または取り消された場合、依存するすべてのタスクが失敗することを指定します。 /faildependenttasks が宣言されているが、値が指定されていない場合、True が想定されます。 /faildependenttasks が宣言されていない場合、False が想定されます。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/failontaskfailure[:{true|false}] | HPC ジョブ スケジューラ サービスがジョブを停止し、ジョブ内のタスクが失敗したときにジョブ全体を直ちに失敗させるかどうかを指定します。 値 True は、HPC ジョブ スケジューラ サービスがジョブを停止し、ジョブ内のタスクが失敗するとすぐにジョブ全体を失敗させる必要があることを示します。 False の値は、ジョブ内のタスクが失敗した後も、HPC ジョブ スケジューラ サービスがジョブ内の残りのタスクを実行し続ける必要があることを示します。 値を指定せずに /failontaskfailure パラメーターを指定すると、ジョブ送信 コマンドは、値 True を指定したかのように動作します。 /failontaskfailure パラメーターを指定しない場合、ジョブの送信 コマンドは、False の値を指定した場合と同様に動作します。 |
/holduntil:[{<DateTime>|<minutes>}] | HPC ジョブ スケジューラ サービスがジョブを開始する前に待機する必要がある日付と時刻を、ローカル時刻または分単位で指定します。 このパラメーターが設定されていない場合、リソースが使用可能になったときにジョブを開始できます。 HPC ジョブ スケジューラ サービスは、ジョブに必要なリソースが使用可能かどうかをこのパラメーターで指定した日時にのみジョブを実行します。 ジョブに必要なリソースがその日時に使用できない場合、ジョブは必要なリソースが使用可能になるまでキューに残ります。 現在のオペレーティング システム カルチャに対して .NET Framework で解析できる任意の形式で日付と時刻を指定できます。 .NET Framework が日付と時刻の文字列を解析する方法については、「日時文字列の解析を参照してください。 ジョブが実行されていないか完了していない限り、ジョブの /holduntil パラメーターを指定できます。 /holduntil を使用して指定された時間は内部的に UTC に変換され、ローカルの夏時間は反映されません。 分の値を使用する場合は、整数である必要があります。 保持する分は、ジョブ変更 が適用 /holduntil の値が空の場合、現在の holduntil 値はすべて消去され、そのパラメーターのためにジョブは保留中ではなくなります。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/jobenv:<variable_and_value_list> | ジョブの実行時環境で設定する環境変数と、それらの環境変数を設定する値を指定します。 リストの形式は、<variable_name1>=<value1> [;<variable_name2>=<value2>...] である必要があります。 または、複数の /jobenv パラメーターを含めることで、複数の環境変数を設定できます。各パラメーターには、<variable_name>=<値>形式の異なる引数があります。 環境変数の設定を解除するには、値を指定しないでください。 たとえば、"<variable_to_unset_name>=" などです。 ジョブの環境変数を設定または設定解除した場合、/env パラメーターを使用して新しい設定を指定してタスクの環境変数設定をオーバーライドしない限り、その環境変数はジョブ内の各タスクにも設定または設定解除されます。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/jobname:<job_name> | コマンド出力およびユーザー インターフェイスで、このジョブに使用する名前を指定します。 ジョブの名前の最大長は 80 文字です。 |
/jobtemplate:<job_template_name> | ジョブに使用するジョブ テンプレートの名前を指定します。 ジョブ テンプレートの名前の最大長は 80 文字です。 既定では、ジョブの送信 コマンドは、新しいジョブの既定のジョブ テンプレートを使用します。 |
/license:<license_list> | ジョブでライセンスが必要な機能の一覧と、それぞれに必要なライセンスの数を指定します。 [,<license_name2>:<number2>... ]<><license_name1>の形式を使用します。 この一覧の場合は 。
<番号..> は、任意の正の整数にすることも、ジョブに割り当てられたコア、ソケット、またはノードと同じ数のライセンスを要求する * でもかまいません。 たとえば、/license1:10,license2:* は、license1 から 10 ライセンス、license2 の N ライセンスが送信されるジョブに関連付けられているコア、ノード、またはソケットの数に関連付けられていることを意味します。 リストの最大長は 160 文字です。 |
/memorypernode:<min>[- max<>] | HPC ジョブ スケジューラ サービスがノードをジョブを実行する候補ノードと見なすためにノードで使用できる最小メモリ量 (MB) を、必要に応じてメガバイト (MB) 単位で指定します。 このジョブは、このパラメーターが指定する最大値よりもメモリが最小値より少ないノードまたはメモリが多いノードでは実行されません。 クラスター内のすべてのノードに、このパラメーターに指定した範囲外のメモリ量がある場合は、ジョブの送信時にエラーが発生します。 |
/name:<task_name> | コマンド出力とユーザー インターフェイスで、このタスクに使用する名前を指定します。 タスクの名前の最大長は 80 文字です。 |
/nodegroup:<node_group_list> | このジョブを実行できるノード グループの一覧を [,<node_group2_name>...] <node_group1_name>形式で指定します。 HPC Job Scheduler Service は、既定でリスト内のすべてのノード グループに属するノードからジョブにリソースを割り当てるか、グループの一覧で /nodegroupop パラメーターの操作に起因するノード (指定されている場合) にリソースを割り当てます。 /nodegroup パラメーターは、有効なノード リスト内にノードがあることを確認します。 ただし、上記のパラメーターのジョブのリソース要件をノード リスト内から満たすことができない場合、ジョブの送信中にジョブは失敗します。 タスク |
/nodegroupop:{Intersect|均一|株式会社ユニホームUnion} |
/nodegroup パラメーターで指定されたリストの演算子を指定します。 有効な値は次のとおりです。 Intersect - リストされているすべてのノード グループに含まれるノードの一覧を作成します。 Uniform - HPC ジョブ スケジューラ サービスがノード グループを順番に試します。 最初のノード グループ内に十分なリソースがある場合は、リソースが使用されます。 そうでない場合、Scheduler は、十分なリソースを持つノード グループが見つかるまで、次の各ノード グループを試行します。 十分なリソースが見つからない場合、ジョブはキューに残ります。 共用体 - 任意のノード グループ内にあるノードの一覧を作成します。 このパラメーターの既定値は Intersect です。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/notifyoncompletion[:{true|false}] | HPC ジョブ スケジューラ サービスがジョブの終了時に電子メール通知を送信するかどうかを指定します。 値 True は、HPC ジョブ スケジューラ サービスがジョブの終了時に電子メール通知を送信する必要があることを示します。 False の値は、HPC ジョブ スケジューラ サービスがジョブの終了時に電子メール通知を送信しないことを示します。 ジョブの状態が [完了]、[失敗]、または [キャンセル] に変わると、ジョブが終了し、通知が送信されます。 ジョブに関する通知を受信するには、クラスター管理者が HPC クラスターの通知を構成する必要があります。 値を指定せずに /notifyoncompletion パラメーターを指定すると、ジョブの新しい コマンドは、値 True を指定したかのように動作します。 /notifyoncompletion パラメーターを指定しない場合、ジョブの新しい コマンドは、値 False を指定した場合と同様に動作します。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/notifyonstart[:{true|false}] | ジョブの開始時に HPC ジョブ スケジューラ サービスが電子メール通知を送信するかどうかを指定します。 値 True は、ジョブの開始時に HPC ジョブ スケジューラ サービスが電子メール通知を送信する必要があることを示します。 False の値は、ジョブの開始時に HPC ジョブ スケジューラ サービスが電子メール通知を送信しないことを示します。 ジョブに関する通知を受信するには、クラスター管理者が HPC クラスターの通知を構成する必要があります。 値を指定せずに /notifyonstart パラメーターを指定すると、ジョブの新しい コマンドは、値 True を指定したかのように動作します。 /notifyonstart パラメーターを指定しない場合、このパラメーターは HPC Pack 2008 R2 で導入され、以前のバージョンではサポートされていません。 ジョブの新しい コマンドは、値 False を指定した場合と同様に動作します。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/numcores:<min>[-<max>] | ジョブに必要な HPC クラスター全体のコア数を、最小<>形式で指定します [-<最大>] です。 ジョブは、少なくとも最小コア数で実行され、最大値以下で実行されます。 値を 1 つだけ指定した場合、このコマンドはコアの最大数と最小数をその値に設定します。 クラスター全体で使用可能なコアの合計数を超える最小値を指定すると、ジョブの送信時にエラーが発生します。 最小値と最大値には、正の整数またはアスタリスク (*) のみを指定できます。 最小値または最大値をアスタリスクとして指定すると、HPC ジョブ スケジューラ サービスは、ジョブ内のタスクのコアの最小数と最大数に基づいて、実行時のコアの最小数または最大数を自動的に計算します。 |
/numnodes:<min>[-<max>] | ジョブに必要な HPC クラスター全体のノードの総数を、最小<>形式で指定します [- 最大<>] です。 ジョブは、少なくともノードの最小数で実行され、最大値以下で実行されます。 1 つの値のみを指定した場合、このコマンドはノードの最大数と最小数の両方をその値に設定します。 クラスター全体で使用可能なノードの合計数を超える最小値を指定すると、ジョブの送信時にエラーが発生します。 最小値と最大値には、正の整数またはアスタリスク (*) のみを指定できます。 最小値または最大値をアスタリスクとして指定すると、HPC ジョブ スケジューラ サービスは、ジョブ内のタスクのノードの最小数と最大数に基づいて、実行時のノードの最小数または最大数を自動的に計算します。 |
/numprocessors:<min>[-<max>] | 廃止。 代わりに、/numcores パラメーターを使用してください。 |
/numsockets:<min>[-<max>] | ジョブに必要な HPC クラスター全体のソケットの総数を、最小<>形式で指定します [-<最大>] です。 ジョブは、少なくとも最小数のソケットで実行され、最大値以下で実行されます。 値を 1 つだけ指定した場合、このコマンドはソケットの最大数と最小数の両方をその値に設定します。 クラスター全体で使用可能なソケットの合計数を超える最小値を指定すると、ジョブの送信時にエラーが発生します。 最小値と最大値には、正の整数またはアスタリスク (*) のみを指定できます。 最小値または最大値をアスタリスクとして指定すると、HPC ジョブ スケジューラ サービスは、ジョブ内のタスクのソケットの最小数と最大数に基づいて、実行時のソケットの最小数または最大数を自動的に計算します。 |
/orderby:<プライマリ>[,<セカンダリ>] | HPC ジョブ スケジューラ サービスがジョブ内のジョブとタスクにノードを割り当てるために使用する順序を指定します。 値のprimary_order部分とsecondary_order部分には、それぞれ次のいずれかの値を指定できます。 memory - HPC ジョブ スケジューラ サービスは、ノードを使用可能なメモリの量で並べ替え、より多くのメモリを持つノードに最初にジョブを割り当てます。 -memory - HPC ジョブ スケジューラ サービスは、ノードを使用可能なメモリの量で並べ替え、メモリが少ないノードに最初にジョブを割り当てます。 コア - HPC ジョブ スケジューラ サービスは、使用可能なコア数でノードを並べ替え、最初にコア数が多いノードにジョブを割り当てます。 -cores - HPC ジョブ スケジューラ サービスは、使用可能なコア数でノードを並べ替え、最初にコア数が少ないノードにジョブを割り当てます。 #0~#63 - HPC ジョブ スケジューラ サービスは、カスタム ノード ソーターを使用してノードを並べ替えます。 この機能は HPC Pack 2016 Update 3 で導入されており、以前のバージョンではサポートされていません。 カスタム ノード ソーターの実装の詳細については、「HPC Pack 2016 Update 3の新機能」を参照してください。 セカンダリ注文を指定すると、HPC ジョブ スケジューラ サービスは最初にプライマリの順序に従ってノードを並べ替えます。 プライマリの順序で指定された同じ量のリソースを持つノードのサブセットの場合、HPC ジョブ スケジューラ サービスは、セカンダリの並べ替え順序を使用してサブセット内のノードを並べ替えます。 たとえば、メモリコアを指定した場合、HPC ジョブ スケジューラ サービスは、ノードを最大メモリ量から最小メモリに並べ替えます。 次に、同じ量のメモリを持つノードのサブセットの場合、HPC ジョブ スケジューラ サービスはコア数を使用してタイを解除し、同じ量のメモリを持つノードを最も少ないコア数から最も多いものに並べ替えます。 プライマリ注文とセカンダリ注文は、さまざまな種類のリソースを参照する必要があります。 たとえば、メモリ、コアは、プライマリとセカンダリの並べ替え順序の有効な組み合わせです。 メモリ、メモリ、コア、コアなどの組み合わせは無効です。 HPC ジョブ スケジューラ サービスが ジョブ にノードを割り当てるために使用する既定の順序は、コア、メモリ、String.CompareTo メソッドによって決定される名前付け順序です。 HPC Pack 2019 Update 3 では、JOB_PACKING_ON_NODE機能フラグをアクティブにすることで、既定の順序を名前付け順序に設定できます。 この機能フラグを有効にするには、次の PowerShell コマンドレットを実行します: Set-HpcClusterProperty -SchedulerEnvFeatureFlags 'JOB_PACKING_ON_NODE' 。 その後、すべてのヘッド ノードで HpcScheduler サービスを再起動します。HPC Pack 2019 Update 1 以前のリリースでは、HPC ジョブ スケジューラ サービスがノードを タスクの に割り当てるために使用する順序は、常に、String.CompareTo メソッドによって決定される名前付け順序によって行われます。 HPC Pack 2019 Update 2 では、HPC ジョブ スケジューラ サービスが /orderby プロパティが指定されていない場合、ノードがタスクに割り当てられる既定の順序は、準備完了コア、メモリ、String.CompareTo メソッドによって決定される名前付け順序。HPC Pack 2019 Update 3 では、HPC ジョブ スケジューラ サービスが Set-HpcClusterProperty -SchedulerEnvFeatureFlags TASK_SPREADING_ON_NODE' または Set-HpcClusterProperty -SchedulerEnvFeatureFlags 'TASK_ON_SINGLE_NODE' ) を実行します。 その後、すべてのヘッド ノードで HpcScheduler サービスを再起動します。 |
/パラメトリック:<index_specification> | 新しいタスクがパラメトリック タスクであることを示します。 パラメトリック タスクは、指定されたコマンドを複数回実行し、コマンド ラインのアスタリスク (*) の現在のインデックス値を置き換えます。 アスタリスクは、 このパラメーターのインデックス指定は、インデックス値の動作を定義します。 インデックス指定の形式は、[start<>-]<end>[:<increment>] です。 現在のインデックス値は開始インデックスから始まり、コマンドが実行されるたびにインクリメント値だけ増加します。 現在のインデックスが終了インデックスを超えると、タスクはコマンドの実行を停止します。 開始インデックスは終了インデックスより小さく、インクリメント値は正の整数である必要があります。 |
/parentjobids: <jobID_list> | ジョブが依存するジョブ ID の一覧を、jobID1<[,>jobID2<...] >形式で指定します。 ジョブ ID は既に存在している必要があります。 HPC ジョブ スケジューラ サービスは、親ジョブが完了し、すべてが完了状態の場合にのみジョブをスケジュールします。 親ジョブが完了していないか完了したが、取り消し済みまたは失敗状態の場合、ジョブはキューに残ります。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/password:<password> | ジョブを実行するアカウントのパスワードを指定します。 /user パラメーターを指定したが、/password パラメーターを指定しない場合、ジョブは コマンドを送信し、パスワードを保存するかどうかを確認するメッセージを表示します。 |
/priority:<priority> | ジョブのスケジュール設定の優先順位を指定します。 Windows HPC Server 2008 の場合、優先度の値は、高値、AboveNormal、Normal、BelowNormal、または Lowest のいずれかになります。 Windows HPC Server 2008 R2 では、Windows HPC Server 2008 で使用できる 5 つの名前付き優先度値のいずれかを使用できます。 0 から 4000 までの任意の数を使用することもできます。0 が最も優先度が低く、4000 が最も高くなります。 また、優先度の値をオフセット 最高- 4000 AboveNormal - 3000 正常 - 2000 BelowNormal - 1000 最低 - 0 ジョブで使用されるジョブ テンプレートは、昇格された優先順位を指定できるユーザーに影響するアクセス許可を指定します。 HPC ジョブ スケジューラ サービスは、ユーザーがジョブを再キューに入れ直さない限り、ユーザーがジョブを送信する順序で、同じ優先度のジョブをジョブ キューに配置します。 ユーザーがジョブを再キューすると、HPC ジョブ スケジューラ サービスは、そのジョブを同じ優先度のジョブの中で最初に配置します。 ジョブの既定の優先度は Normal または 2000 です。 |
/progress:<percent_progress> | 完了したジョブの割合を指定します。 この値は、 このプロパティの値を設定しない場合、HPC ジョブ スケジューラ サービスは、ジョブの完了したタスクの割合に基づいて進行状況を計算します。 ジョブに対してこのプロパティを設定すると、HPC ジョブ スケジューラ サービスはこのプロパティを引き続き更新しないため、ジョブ変更コマンドを使用してプロパティ 更新し続ける必要があります。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/progressmsg: メッセージ<> | ジョブに対して表示するカスタム ステータス メッセージを指定します。 この文字列の最大長は 80 文字です。 スペースを含むステータス メッセージを指定するには、ステータス メッセージを引用符 (") で囲みます。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/projectname:<名前> | ジョブの追跡に使用できるジョブのプロジェクト名を指定します。 プロジェクト名の最大長は 80 文字です。 |
/requestednodes:<node_list> | ジョブを実行できるノードの名前の一覧を、<node1_name>[,<node2_name>...] の形式で指定します。 これらのノードはジョブの候補ですが、これらのノードで使用可能なリソースがジョブに必要なリソースを超えた場合、すべてのノードが必ずしもジョブを実行するとは限りません。 HPC ジョブ スケジューラ サービスは、割り当てられたノードが、/numcores、/numsockets、/numprocessors、または /numnodes パラメーターで指定した値を満たすまで、/orderby パラメーターの値に従って最上位ノードを割り当てます。 /requestednodes パラメーターを指定しない場合、HPC ジョブ スケジューラ サービスはすべてのノードを、HPC ジョブ スケジューラ サービスがジョブに割り当てることができる候補と見なします。 |
/rerunnable[:{true|false}] | HPC ジョブ スケジューラ サービスがタスクを実行して失敗した場合にタスクの再実行を試みるかどうかを指定します。 値 True は、タスクが割り込まれた場合、またはノードが到達不能になったなどのクラスターの問題によって失敗した場合に、HPC ジョブ スケジューラ サービスがタスクの再実行を試みることができることを示します。 ジョブ スケジューラは、完了するまで実行されるタスクの再実行を試行せず、終了コードが失敗した状態で返されます。 False の値は、タスクが開始されたが、プリエンプションまたはクラスターの問題が原因で完了しなかった場合に、HPC ジョブ スケジューラ サービスがタスクの再実行を試みないことを示します。 代わりに、タスクをすぐに失敗状態に移動する必要があります。 クラスター管理者は、HPC ジョブ スケジューラ サービスが再実行可能なタスクを再実行してから、タスクを失敗状態に移行しようとする回数を構成できます。 /rerunnable パラメーターを指定しない場合、コマンドは True の値を指定したかのように動作します。 |
/runtime:{<time> |Infinite} | ジョブを実行する最大時間を指定します。 この期間ジョブが実行されると、HPC ジョブ スケジューラ サービスによってジョブが取り消されます。 [[<日>:]<時間>:]<分>形式で時間を指定します。 また、Infinite を指定して、ジョブを無制限の時間実行できることを示すこともできます。 [[<日>:]<時間>:]<分> 形式の一部のみを指定すると、指定した値が分数として解釈されます。 たとえば、12 は 12 分を示します。 書式の 2 つの部分を指定した場合、コマンドは左側の部分を時間として解釈し、右側の部分を分として解釈します。 たとえば、10:30 は 10 時間 30 分を示します。 書式の各部分に 1 つ以上の数字を使用できます。 各パーツの最大値は 2,147,483,647 です。 /runtime パラメーターを指定しない場合、既定値は Infinite です。 |
/rununtilcanceled[:{true|false}] | 実行時制限の有効期限が切れるか、誰かがジョブを取り消すまで、ジョブの実行とリソースの保持を継続するかどうかを指定します。 値 True は、実行時の制限が期限切れになるか、誰かがジョブを取り消すまで、ジョブの実行と保持を継続することを示します。 True の値を指定する場合は、 False の値は、ジョブ内のすべてのタスクが完了したときに、ジョブがリソースを停止して解放する必要があることを示します。 値を指定せずに /rununtilcanceled パラメーターを指定すると、ジョブ送信 コマンドは、値 True を指定したかのように動作します。 /rununtilcanceled パラメーターを指定しない場合、ジョブの送信 コマンドは、False の値を指定した場合と同様に動作します。 |
/scheduler:<名前> | タスクを送信するクラスターのヘッド ノードのホスト名または IP アドレスを指定します。 値は、有効なコンピューター名または IP アドレスである必要があります。 /scheduler パラメーターを指定しない場合、このコマンドは、CCP_SCHEDULER環境変数が指定するヘッド ノード上のスケジューラを使用します。 |
/singlenode[:{true|false}] | すべてのリソースが 1 つのノードに割り当てられることを指定します。 /singlenode が宣言されているが、値が指定されていない場合、True が想定されます。 /singlenode が宣言されていない場合、False と見なされます。 このパラメーターは HPC Pack 2012 で導入され、以前のバージョンではサポートされていません。 |
/stderr:[<パス>\]<file_name> | タスクが標準エラー ストリームを作業ディレクトリ内のファイルにリダイレクトしない場合に、ファイルの作業ディレクトリを基準とする完全パスまたは相対パスなど、タスクが標準エラー ストリームをリダイレクトするファイルの名前を指定します。 存在しないパスを指定すると、タスクは失敗します。 /stderr パラメーターを指定しない場合、タスクは、タスクの Output プロパティが指定する HPC ジョブ スケジューラ サービスのデータベースに最大 4 KB のデータを格納します。 4 KB を超える出力はすべて失われます。 このパラメーターの値の最大長は 160 文字です。 |
/stdin:[<パス>\]<file_name> | タスクが作業ディレクトリ内のファイルから標準入力を受け取らない場合に、ファイルの作業ディレクトリを基準とする完全パスまたは相対パスなど、タスクが標準入力を受け取るファイルの名前を指定します。 存在しないファイルまたはパスを指定すると、タスクは失敗します。 このパラメーターの値の最大長は 160 文字です。 |
/stdout:[<パス>\]<file_name> | タスクが標準出力を作業ディレクトリ内のファイルにリダイレクトしない場合に、ファイルの作業ディレクトリを基準とする完全パスまたは相対パスなど、タスクが標準出力をリダイレクトするファイルの名前を指定します。 存在しないパスを指定すると、タスクは失敗します。 /stdout パラメーターを指定しない場合、タスクは、タスクの Output プロパティが指定する HPC ジョブ スケジューラ サービスのデータベースに最大 4 KB のデータを格納します。 4 KB を超える出力はすべて失われます。 このパラメーターの値の最大長は 160 文字です。 |
/taskexecutionfailureretrylimit:<retry_limit> | アプリケーションの実行エラーが発生した後に、ノード準備タスクまたはノード解放タスク以外のこのジョブのタスクが自動的に再キューされる最大回数を指定します。 このパラメーターは、HPC Pack 2012 R2 Update 1 で導入されました。 以前のバージョンでは使用できません。 |
/type:<type_name> | タスクのコマンドの実行方法を定義するタスクの種類を指定します。 指定できる型を次に示します。 基本的な- シリアル アプリケーションまたはメッセージ パッシング インターフェイス (MPI) アプリケーションの 1 つのインスタンスを実行します。 MPI アプリケーションは通常、複数のコアで同時に実行され、複数のノードにまたがることができます。 NodePrep - ジョブに割り当てられる各コンピューティング ノードでコマンドまたはスクリプトを実行します。 ノード準備タスクは、ジョブ内の他のタスクの前にノードで実行されます。 ノード準備タスクがノードで実行できない場合、そのノードはジョブに追加されません。 NodeRelease - ジョブから解放されると、各コンピューティング ノードでコマンドまたはスクリプトを実行します。 ノード 解放タスクは、ジョブがユーザーまたはグレースフル プリエンプションによって取り消されたときに実行されます。 ノード解放タスクは、ジョブが即時プリエンプションによって取り消されたときには実行されません。 パラメトリックスウィープ - は、Start、End、Increment の各値で示される指定された回数だけコマンドを削除します。通常は、インデックス付きの入力ファイルと出力ファイル間で実行されます。 タスクの実行中に HPC クラスターで使用できるリソースによっては、スイープのステップが並列で実行される場合と実行されない場合があります。 ParametersSweep 型を指定する場合は、/パラメトリック パラメーターを使用して、インデックスの開始値、終了値、インクリメント値を指定する必要があります。 /パラメトリック パラメーター サービス- ジョブに割り当てられているすべてのリソースに対してコマンドまたはサービスを実行します。 コマンドの新しいインスタンスは、新しいリソースがジョブに追加されたとき、または以前に実行中のインスタンスが終了し、以前に実行されていたインスタンスが使用されたリソースがまだジョブに割り当てられている場合に開始されます。 サービス タスクは、タスクが取り消されるか、最大実行時間が期限切れになるか、インスタンスの最大数に達するまで、新しいインスタンスを開始し続けます。 サービス タスクは、最大 1,000,000 個のサブタスクを作成できます。 サービス指向アーキテクチャ (SOA) クライアントを通じて送信するタスクは、サービス タスクとして実行されます。 サービス タスクを含むジョブに、基本タスクまたはパラメトリック スイープ タスクを追加することはできません。 /パラメトリック パラメーターも指定しない限り、このパラメーターの既定値は Basic です。 /parametric パラメーターを指定した場合、/type パラメーターの既定値は[パラメトリックスウィープ]です。 /type パラメーターに、ParametersSweep 以外の値を指定した場合は、/パラメトリック パラメーターも指定できません。 このパラメーターは HPC Pack 2008 R2 で導入されており、以前のバージョンではサポートされていません。 |
/workdir: フォルダー<> | タスクを実行する作業ディレクトリを指定します。 このパラメーターの値の最大長は 160 文字です。 |
<コマンド> [<parameters>] | コマンドまたはアプリケーション名、必要なパラメーターなど、タスクのコマンド ラインを指定します。 /taskfile タスク XML ファイル内で定義されていない限り、タスクを追加するにはコマンドが存在する必要があります。 コマンドは、完全修飾パスが含まれている場合を除き、作業ディレクトリに対して相対的に実行されます。 |
/user:[<domain>\]<user_name>] | ジョブを実行するアカウントのユーザー名と、必要に応じてドメインを指定します。 このパラメーターを指定しない場合、ジョブはジョブの送信に使用されたアカウントで実行されます。 |
/validexitcodes:{int|intStart..intEnd} [,{int|intStart..intEnd}]* | ジョブ内のタスクが正常に終了したかどうかを確認するために使用する終了コードを指定します。
/validexitcodes は、コンマで区切られた個別の整数と整数範囲で指定する必要があります。 最小 または最大 は、整数範囲の開始または終了として使用できます。 たとえば、 0..max は負でないすべての整数を表します。このパラメーターは、タスクに固有のパラメーター |
/? | コマンド プロンプトにヘルプを表示します。 |
/ヘルプ | コマンド プロンプトにヘルプを表示します。 |
備考
ジョブ送信 コマンドには、3 つの主要な形式があります。
/password 、/user 、および /scheduler パラメーターは、3 つのフォームすべてに共通です。 コマンドの最初の形式には、/id パラメーターも含まれており、指定されたジョブ識別子を持つ既存のジョブを送信します。
コマンドの 2 番目の形式には、共通パラメーターに加えて、/jobfile パラメーターが含まれています。 このフォームは、ジョブ ファイルで指定された設定とタスクを使用して新しいジョブを作成し、すぐにそのジョブを送信します。
コマンドの 3 番目の形式には、コマンド プロンプトにヘルプ メッセージを表示するパラメーターを除き、残りのパラメーターが含まれています。 この形式のコマンドは、指定したコマンドを実行する 1 つのタスクで新しいジョブを作成し、そのジョブを送信します。
ジョブを送信すると、HPC ジョブ スケジューラ サービスによってジョブが検証され、ジョブ キューにジョブが入力されます。 HPC ジョブ スケジューラ サービスは、十分なリソースが使用可能になるまでジョブの開始を待機します。
Windows HPC Server 2008 R2 以降では、パラメーター タスクのコマンド ラインのアスタリスク (*) を、3 つのキャレット (^) 文字の前に置き換えて、パラメトリック インデックスの現在の値に置き換えないように指定できます。 たとえば、ジョブ送信 コマンドを使用して、1 つのパラメトリック タスクでジョブを送信し、コマンド ラインを echo * として指定すると、タスクはパラメトリック インデックスの値を出力します。 代わりに、ジョブ add コマンドを使用してパラメトリック タスクを作成し、コマンド ラインを echo ^^^* として指定すると、タスクはパラメトリック インデックスの値ごとにアスタリスクを出力します。
例
38のジョブ識別子を持つジョブを送信するには、次のコマンドを使用します。
job submit 38
C:\Jobs\MyJob.xml ファイルの設定を使用して新しいジョブを作成し、すぐにジョブを送信するには、次のコマンドを使用します。
job submit /jobfile:C:\Jobs\MyJob.xml
ジョブの種類が Basic の新しい単一タスク ジョブを作成して送信するには、ジョブの開始時に電子メール通知を送信し、状態メッセージが "Submitted" で、vol コマンドを実行するには、次のコマンドを使用します。
job submit /notifyonstart:true /progressmsg:"Submitted" /type:Basic vol
新しいジョブを作成するには、ジョブにタスクを追加してからジョブを送信し、次のコマンドを含むバッチ ファイルを実行します。このファイルでは、 コマンドの
for /f "usebackq tokens=4 delims=. " %%i in (`job new`) do (
job add %%i echo Hello World
job submit /id:%%i
)
その他の参照
ジョブの新しい を
する ジョブ 取り消し
ジョブ の