jpqagtlink

〈このページの構成〉

形式
機能
実行権限
引数
注意事項
戻り値

形式

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

ページの先頭へ

機能

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

ページの先頭へ

実行権限

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

JP1_JPQ_Admin権限

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

Windowsの場合：Administrators権限
UNIXの場合：スーパーユーザー権限

ページの先頭へ

引数

`-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アドレスは指定できません。

ページの先頭へ

注意事項

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

ページの先頭へ

戻り値

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

ページの先頭へ