jpqagtalt

形式

jpqagtalt
    [-mh マネージャーホスト名]
    -ah エージェントホスト名
    -cp 時刻-時刻=ジョブ実行多重度...
    [-em]

機能

同時に実行できるジョブ数(ジョブ実行多重度)を変更します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

ただし,-emオプションを指定する場合は次の権限が必要です(JP1_JPQ_Admin権限は必要ありません)。

引数

-mh マネージャーホスト名

ジョブ実行多重度を変更したいエージェントホストが接続されている,マネージャーホスト名を指定します。

指定できる文字数は,1~255(単位:バイト)です。

省略した場合,自ホスト名が仮定されます。

-emオプションと同時に指定する場合,指定できるホスト名は,ローカルホスト名またはローカルホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー(エラーコード25)となります。また,この場合,-mhオプションにエイリアスホスト名を指定することはできません。

-ah エージェントホスト名

ジョブ実行多重度を変更したいエージェントホスト名を指定します。

指定できる文字数は,1~255(単位:バイト)です。

-cp 時刻-時刻=ジョブ実行多重度

ジョブ実行多重度を変更する期間と,その期間のジョブ実行多重度を指定します。

ジョブ実行多重度を指定することによって,このエージェントホストで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは,標準ジョブ(UNIXジョブ,PCジョブ,QUEUEジョブ),アクションジョブ,およびカスタムジョブです。同時に実行しようとしたジョブ数が,実行多重度に達した場合,実行多重度を超えた分のジョブは,実行中のジョブが終了するまでキューイング(実行待ち)の状態になります。

期間は,時刻と時刻とを「-(ハイフン)」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は,0または00~23(単位:時)です。

mmに指定できる値は,0,00,または30(単位:分)です。

実行多重度に指定できる値は,0~4,294,967,295です。

コマンド投入時刻を含む期間を指定した場合,実行多重度はすぐに変更されます。

期間と実行多重度は複数指定できます。ただし,期間を重複して指定した場合は,あとで指定した値が反映されます(例えば,「-cp 1:00-2:30=5 2:00-4:00=10」と指定した場合,重複している2:00~2:30の実行多重度は10です)。

後述の「補足事項」に,ジョブ実行多重度の指定例が記載されています。必要に応じて参照してください。

-em

緊急実行時に指定します。

このオプションを指定すると,通常とは異なる通信経路に対して要求するため,障害時などに緊急で実行できるようになります。

なお,このオプションを指定する場合,マネージャーホスト名にIPアドレスは指定できません。

注意事項

戻り値

0正常終了。
1引数の指定が不適切である。
2ジョブ実行多重度の変更依頼側の内部的要因で,ジョブ実行多重度の変更に失敗した。
5初期化に失敗した。
  • 論理ホスト名の定義または環境設定に誤りがある。
6ジョブ実行多重度の変更依頼側でメモリー不足が発生した。
7ジョブ実行多重度の変更依頼側で論理不正が発生した。
25マネージャーホスト名の指定にローカルホスト名および論理ホスト名以外を指定した。
100TCP/IP通信でマネージャーホストに接続できない。
  • TCP/IPが正しく設定されていないため,マネージャーホストに接続できない。
  • マネージャーホスト名に誤りがある。または,マネージャーホストがプロセス停止状態である。
102マネージャーホスト名によるIPアドレスの解決に失敗した。
200マネージャーホストがジョブ実行多重度の変更を受け付けない。
  • マネージャーホストが運用開始処理中,運用停止処理中,運用停止中,または縮退運転中である。
201指定したエージェントホストが使用できない。
  • 指定したエージェントホストがない。
202マネージャーホストから応答がない。
203マネージャーホスト側の内部的要因で,ジョブ実行多重度の変更に失敗した。
206ジョブ実行多重度を変更する権限がない。
219マネージャーホストがビジー状態である。
220マネージャーホスト側でメモリー不足が発生した。
222致命的なエラーが発生した。
  • システムコールでエラーが発生した。
223マネージャーホスト側で論理不正が発生した。
224JP1/AJS2以外のホストに要求した。
226実行環境が不適切である。

補足事項

ジョブ実行多重度の指定例を次に示します。