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/AJS3から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コマンドでエージェントホストを登録してください。
-