jpqagtlink

形式

jpqagtlink
    [-mh マネージャーホスト名]
    {-q キュー名|-ah エージェントホスト名}
    -lh 接続エージェントホスト名
    {[-lp 未接続エージェントホストの優先順位]|
         -clp 接続済みエージェントホストの優先順位}
    [-em]

機能

キューにエージェントホストを接続します。また,キューに接続するエージェントホストの優先順位を設定します。

実行権限

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

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

引数

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

エージェントホストを接続したいキューが作成されているマネージャーホスト名,または優先順位を設定したいエージェントホストが接続されているキューが作成されているマネージャーホスト名を指定します。

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

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

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

-q キュー名

デフォルトキューを除くキューにエージェントホストを接続したい場合,または該当するキューに優先順位を設定したいエージェントホストが接続されている場合に,そのキュー名を指定します。

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

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

デフォルトキューにエージェントホストを接続したい場合,または該当するデフォルトキューに優先順位を設定したいエージェントホストが接続されている場合に,そのデフォルトキュー作成時にマネージャーホストに登録したエージェントホスト名(デフォルトキュー名)を指定します。

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

-lh 接続エージェントホスト名

該当するキューに接続したいエージェントホスト名,または優先順位を設定したいエージェントホスト名を指定します。

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

-lp 未接続エージェントホストの優先順位

接続先エージェントホストの優先順位を指定します。

指定できる値は,1~16です。優先順位がいちばん低いのが1,いちばん高いのが16です。優先順位が高いほど,ジョブが優先的に実行されます。

省略した場合,16が仮定されます。

このオプションは,このコマンドを実行して-lhオプションに指定したエージェントホストを-qオプションで指定したキューまたは-ahオプションで指定したデフォルトキューに接続する際に,接続するエージェントホストの優先順位を設定したい場合に使用してください。

-clp 接続済みエージェントホストの優先順位

接続先エージェントホストの優先順位を指定します。

指定できる値は,1~16です。優先順位がいちばん低いのが1,いちばん高いのが16です。優先順位が高いほど,ジョブが優先的に実行されます。

このオプションは,このコマンドの実行時に-lhオプションに指定したエージェントホストが-qで指定したキューまたは-ahオプションで指定したデフォルトキューに接続済みの際に,該当するエージェントホストの優先順位を変更したい場合に指定してください。

-em

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

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

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

注意事項

  1. このコマンドは,JP1/NQSEXECおよびJP1/OJE for VOS3との連携には使用できません。
  2. -emオプションは,エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合,障害発生時に対応できなくなるおそれがあります。

戻り値

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