jpqagtadd
形式
jpqagtadd [-mh マネージャーホスト名] -ah エージェントホスト名 [-cp 時刻-時刻=ジョブ実行多重度...]
機能
マネージャーホストにエージェントホストを登録します。同時に,そのエージェントホストが接続するにデフォルトキューを作成します。
実行権限
次に示すJP1権限レベルを与えられたユーザー
-
JP1_JPQ_Admin権限
引数
-mh マネージャーホスト名
エージェントホストを登録したいマネージャーホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
省略した場合,自ホスト名が仮定されます。
-ah エージェントホスト名
登録したいエージェントホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
-cp 時刻-時刻=ジョブ実行多重度...
ジョブ実行多重度を指定する期間と,その期間のジョブ実行多重度を指定します。
ジョブ実行多重度を指定すると,このエージェントホストで同時に実行できるジョブ数を制限できます。このコマンドで同時実行数が制限されるジョブは,QUEUEジョブおよびサブミットジョブです。同時に実行しようとしたジョブ数が実行多重度に達した場合,実行多重度を超えた分のジョブは,実行中のジョブが終了するまでキューイング(実行待ち)の状態になります。
期間は,時刻と時刻とを「-(ハイフン)」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。
hhに指定できる値は,0または00〜23(単位:時)です。
mmに指定できる値は,0,00,または30(単位:分)です。
実行多重度に指定できる値は,0〜4,294,967,295です。
省略した場合,「0:00-0:00=0」(24時間,実行多重度は0)が仮定されます。
ジョブ実行多重度が0の場合,ジョブは実行できません。ジョブを実行する場合は1以上を指定するか,jpqagtaltコマンドでジョブ実行多重度を変更してください。
ジョブ実行多重度の指定例については,jpqagtaltコマンドの補足事項も参照してください。
日をまたいで指定できます(例えば,「-cp 3:00-3:00=10」と指定した場合,午前3時から翌日の午前3時の間,実行多重度は10になります)。
期間と実行多重度は複数指定できます。期間を重複して指定した場合は,あとで指定した値が反映されます(例えば,「-cp 1:00-2:30=5 2:00-4:00=10」と指定した場合,重複している2:00〜2:30の実行多重度は10です)。
注意事項
-
このコマンドは,JP1/NQSEXECおよびJP1/OJE for VOS3との連携には使用できません。
-
ジョブ実行多重度を指定しなかった期間には,実行多重度0が仮定されます(例えば,「-cp 10:00-22:00=10」だけ指定した場合,00:00〜10:00の実行多重度は0,10:00〜22:00の実行多重度は10,22:00〜00:00の実行多重度は0になります)。
-
このコマンドは複数を並行して実行した場合,処理にかなり時間が掛かります。複数のエージェントホストを登録する場合は,一つずつ登録してください。
戻り値
0 |
正常終了。 |
1 |
引数の指定が不適切である。 |
2 |
jpqagtaddコマンドを実行したホストの内部的要因で,エージェントホストの登録に失敗した。 |
5 |
初期化に失敗した。
|
6 |
jpqagtaddコマンドを実行したホストでメモリー不足が発生した。 |
7 |
jpqagtaddコマンドを実行したホストで論理不正が発生した。 |
100 |
TCP/IP通信でjpqagtaddコマンドを実行したホストからマネージャーホストに接続できない。
|
102 |
jpqagtaddコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。 |
200 |
マネージャーホストがエージェントホストの登録を受け付けない。
|
202 |
マネージャーホストから応答がない。 |
203 |
マネージャーホストの内部的要因で,エージェントホストの登録に失敗した。 |
206 |
エージェントホストを登録する権限がない。 |
219 |
マネージャーホストがビジー状態である。 |
220 |
マネージャーホストでメモリー不足が発生した。 |
222 |
致命的なエラーが発生した。
|
223 |
マネージャーホストで論理不正が発生した。 |
224 |
JP1/AJS3以外のホストに要求した。 |
226 |
実行環境が不適切である。 |
232 |
登録しようとしたエージェントホストと同じ名称のエージェントホストがすでにある。 |
235 |
エージェントホストの最大定義数を超える。 |
240 |
イベント・アクション制御マネージャーがエージェントの構成定義を変更中である。 |
補足事項
-
このコマンドの実行によって,エージェントホストの登録と同時に作成されるデフォルトキューの属性と,属性を変更したい場合に使用するコマンドを次の表に示します。
デフォルトキューの
設定項目
属性
属性を変更したい場合に
使用するコマンド
ジョブ実行多重度
-cpオプションに指定した値
jpqagtalt
ジョブ数の最大値
4,294,967,295
jpqquealt
ジョブ数の警告値
4,294,967,295
jpqquealt
ジョブの受付口の状態
close
jpqqueopen
ジョブの取出口の状態
open
jpqqueclose
接続するエージェントホスト
-ahオプションに指定したエージェントホスト名
jpqagtunlink,
jpqagtlink
エージェントホストの優先順位
16
jpqagtlink
-
jpqagtaddコマンドでエージェントホストを登録した直後は,キューの受付口は閉じているのでジョブの登録はできません。jpqqueopenコマンドを使用してキューの受付口を開いてください。また,登録したエージェントホスト名はIPアドレス解決できることを確認しておく必要があります。jpqimportコマンドで登録したときのデフォルト値と同じ設定のエージェントホストを登録する場合の手順は次のようになります。
-
該当するマネージャーホストにエージェントホストを登録し,ジョブ実行多重度を設定する。
jpqsetup.confのデフォルト値は,24時間 ジョブ実行多重度5です。
jpqagtadd -ah エージェントホスト名 -cp ジョブ実行多重度の設定
-
デフォルトキューの受付口を開く。
jpqqueopen -ah エージェントホスト名 -en
-
デフォルトキューのジョブ数の最大値,ジョブ数の警告値を変更する。
jpqsetup.confのデフォルト値は,ジョブ数の最大値は「100」ジョブ数の警告値は「80」です。
jpqquealt -ah エージェントホスト名 -mj ジョブ数の最大値 -wj ジョブ数の警告値
-
接続するエージェントホストの優先順位を変更する。
jpqsetup.confのデフォルト値は,優先順位に「1」を設定しています。
jpqagtlink -ah エージェントホスト名 -lh エージェントホスト名 -clp 接続先エージェントホストの優先順位
なお,jpqagtaddコマンドでエージェントホストを登録する場合,エージェントIDは自動的に割り当てられます。エージェントIDを明示的に指定したい場合は,jpqimportコマンドでエージェントホストを登録してください。
-