ftePingAgent（「MFTエージェントがアクティブかどうかをチェックする）

ftePingAgent コマンドは、 Managed File Transfer エージェントを ping して、そのエージェントが到達可能かどうかを判別し、到達可能な場合は、単純な照会に応答できるかどうかを判別します。

目的

ftePingAgent コマンドを使用して、 Managed File Transfer エージェントが到達可能であるかどうかを確認し、到達可能である場合は、 are you there?の行に沿って単純な照会に応答できるかどうかを確認します。このコマンドの出力例を以下に示します。

C:&#xa5;> ftePingAgent AGENT86
5724-H72 Copyright IBM 2008, 2025.  All Rights Reserved
BFGPR0127W: No credentials file has been specified to connect to IBM MQ. Therefore, the assumption is that IBM MQ authentication has been disabled.
BFGCL0212I: Issuing ping request to agent AGENT86
BFGCL0213I: agent AGENT86 responded to ping in 0.094 seconds.

デフォルト・セットとは異なる構成オプションのセットを使用する場合にのみ、このコマンドにオプションの-pパラメーターを指定してください。詳しくは、構成オプションを参照してください。

構文

ftePingAgent

パラメーター

-p configuration_options: オプション。このパラメーターは、エージェントを ping する要求を発行するために使用される構成オプションのセットを決定します。このパラメーターの入力には、デフォルト調整キュー・マネージャー以外の名前を使用します。これで、コマンドは、デフォルト以外の調整キュー・マネージャーと関連付けられたプロパティー・ファイルのセットを使用します。このパラメーターを指定しない場合、デフォルトの調整キュー・マネージャーに基づいた構成オプションのセットが使用されます。詳しくは、構成オプションを参照してください。
-m agent_queue_manager: オプション。 ping 対象のエージェントが接続されているキュー・マネージャーの名前。 -m パラメーターを指定しない場合、使用されるキュー・マネージャーは、使用中の構成オプションのセットから決定されます。
-w Timeout: オプション。コマンドがエージェントの応答を timeout で示される秒数まで待機することを指定します。 timeout を指定しない場合、または timeout 値に -1 を指定した場合、コマンドはエージェントの応答を無期限に待機します。このオプションを指定しない場合、デフォルトではエージェントの応答を 5 秒まで待機します。; timeout を指定すると、ftePingAgent コマンド・メッセージは、指定された送達不能キューに入れられずに、timeout 値の 2 倍の時間の経過後にタイムアウトになります。コマンドが無期限に待機するよう設定されている場合、コマンド・メッセージはタイムアウトになりません。
-mquserid ユーザー ID: オプション。コマンド・キュー・マネージャーで認証するユーザー ID を指定します。
-mqpassword パスワード: オプション。調整キュー・マネージャーで認証するパスワードを指定します。; -mqpassword パラメーターを指定する場合は、 -mquserid パラメーターも指定する必要があります。 -mquseridを指定し、 -mqpasswordを指定しない場合は、関連付けられたパスワードを入力するように求めるプロンプトが出されますが、これは表示されません。
IBM® MQ 9.3 以降、このコマンドはデフォルトで MQCSP 認証を使用するようになり、認証されるユーザー ID とパスワードを MQCSP 構造でキュー・マネージャーに送信します。
-ノルプウ: オプション。 12 文字を超えるパスワードをサポートしないキュー・マネージャーにコマンドが接続する場合は、このパラメーターを指定します。; -nolpw パラメーターを指定する場合は、 -mquserid パラメーターも指定する必要があります。 -mquserid および -nolpwを指定し、 -mqpasswordを指定しない場合は、関連付けられたパスワードを入力するように求めるプロンプトが出されますが、これは表示されません。
注: -nolpw オプションを指定し、パスワードが 12 文字より長い場合、コマンドは失敗し、エラー・メッセージ BFGCL0829Eが表示されます。
agent_name: 必須。 ping を実行する Managed File Transfer エージェントの名前。
- ? または -h: オプション。コマンド構文を表示します。

例

この例では、コマンドは、QM_MERCURY に接続されたエージェント AGENT1 を ping します。コマンドは、AGENT1 の応答を 40 秒まで待機してから戻ります。

ftePingAgent -m QM_MERCURY -w 40 AGENT1

戻りコード

0: コマンドは正常に完了しました。エージェントはアクティブで、転送を処理できます。
1: コマンドは失敗しました。コマンドはメッセージをエージェントに送信できませんでした。
2: コマンドはタイムアウトになりました。コマンドはメッセージをエージェントに送信しましたが、エージェントは時間内に応答しませんでした。