形式
jpqagtadd
[-mh マネージャーホスト名]
-ah エージェントホスト名
[-cp 時刻-時刻=ジョブ実行多重度...]
機能
マネージャーホストにエージェントホストを登録します。同時に,そのエージェントホストが接続するにデフォルトキューを作成します。
実行権限
次に示すJP1権限レベルを与えられたユーザー
引数
-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です)。
注意事項
戻り値
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 |