jpqagtadd

形式

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です)。

注意事項

  1. このコマンドは,JP1/NQSEXECおよびJP1/OJE for VOS3との連携には使用できません。
  2. ジョブ実行多重度を指定しなかった期間には,実行多重度0が仮定されます(例えば,「-cp 10:00-22:00=10」だけ指定した場合,00:00~10:00の実行多重度は0,10:00~22:00の実行多重度は10,22:00~00:00の実行多重度は0になります)。
  3. このコマンドは複数を並行して実行した場合,処理にかなり時間が掛かります。複数のエージェントホストを登録する場合は,一つずつ登録してください。

戻り値

0正常終了。
1引数の指定が不適切である。
2jpqagtaddコマンドを実行したホストの内部的要因で,エージェントホストの登録に失敗した。
5初期化に失敗した。
  • 論理ホスト名の定義または環境設定に誤りがある。
6jpqagtaddコマンドを実行したホストでメモリー不足が発生した。
7jpqagtaddコマンドを実行したホストで論理不正が発生した。
100TCP/IP通信でjpqagtaddコマンドを実行したホストからマネージャーホストに接続できない。
  • TCP/IPが正しく設定されていないため,jpqagtaddコマンドを実行したホストからマネージャーホストに接続できない。
  • マネージャーホスト名に誤りがある。または,マネージャーホストがプロセス停止状態である。
102jpqagtaddコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。
200マネージャーホストがエージェントホストの登録を受け付けない。
  • マネージャーホストが運用開始処理中,運用停止処理中,運用停止中,または縮退運転中である。
202マネージャーホストから応答がない。
203マネージャーホストの内部的要因で,エージェントホストの登録に失敗した。
206エージェントホストを登録する権限がない。
219マネージャーホストがビジー状態である。
220マネージャーホストでメモリー不足が発生した。
222致命的なエラーが発生した。
  • システムコールでエラーが発生した。
223マネージャーホストで論理不正が発生した。
224JP1/AJS3以外のホストに要求した。
226実行環境が不適切である。
232登録しようとしたエージェントホストと同じ名称のエージェントホストがすでにある。
235エージェントホストの最大定義数を超える。
240イベント・アクション制御マネージャーがエージェントの構成定義を変更中である。

補足事項