プロトコル・ファイル・サーバー・プロパティーの検索: ProtocolBridgePropertiesExit2

プロトコル・ファイル・サーバーが多数ある場合は、com.ibm.wmqfte.exitroutine.api.ProtocolBridgePropertiesExit2 インターフェースを実装して、転送で参照されているプロトコル・ファイル・サーバー・プロパティーを検索できます。 このインターフェースは、 ProtocolBridgeProperties.xml ファイルを保守するように設定することができます。

本タスクについて

Managed File Transfer には、プロトコル・ファイル・サーバー・プロパティーを検索するサンプル・ユーザー出口が用意されています。 詳しくは、 サンプル・ユーザー出口を使用したプロトコル・ファイル・サーバー・プロパティーの検索を参照してください。

プロトコル・ブリッジ・プロパティーを検索するユーザー出口は、インターフェース com.ibm.wmqfte.exitroutine.api.ProtocolBridgePropertiesExit2 を実装する必要があります。 詳細は ProtocolBridgePropertiesExit インターフェースを参照してください。

他のユーザー出口と同じように、複数のプロトコル・サーバー・プロパティー出口をまとめてチェーニングできます。 出口は、エージェント・プロパティー・ファイルで protocolBridgePropertiesExitClasses プロパティーを使用して指定された順序で呼び出されます。 initialize メソッドはすべて個別に値を返します。1 つ以上のメソッドが値 false を返す場合は、エージェントは開始しません。 エージェントのイベント・ログにエラーが報告されます。

すべての出口の getProtocolServerProperties メソッドについては、1 つの全体的な結果のみが返されます。 メソッドがプロパティー・オブジェクトを結果コードとして返す場合、この値は返された結果となり、後続の出口の getProtocolServerProperties メソッドは呼び出されません。 メソッドがヌル値を結果コードとして返す場合は、次の出口の getProtocolServerProperties メソッドが呼び出されます。 後続の出口がない場合は、ヌルの結果が返されます。 全体的な結果コードがヌルである場合は、プロトコル・ブリッジ・エージェントによる検索が失敗したとみなされます。

ProtocolBridgePropertiesExit2.javaの使用が推奨されますが ProtocolBridgePropertiesExitに関する情報は 、「プロトコルファイルサーバープロパティの検索 ProtocolBridgePropertiesExit を参照してください。

出口を実行するには、以下のステップを実行します。

手順

  1. プロトコル・サーバー・プロパティー・ユーザー出口をコンパイルします。
  2. コンパイル済み出口とそのパッケージ構造を含む Java アーカイブ (JAR) ファイルを作成します。
  3. 出口クラスを含む JAR ファイルを、プロトコル・ブリッジ・エージェントの exits ディレクトリーに配置します。 このディレクトリーは、 MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/bridge_agent_name ディレクトリーにあります。
  4. プロトコル・ブリッジ・エージェントのプロパティー・ファイルを編集して、プロパティー protocolBridgePropertiesExitClassesを組み込みます。 このプロパティーの値には、プロトコル・ブリッジ・サーバー・プロパティー・ユーザー出口を実装するクラスのコンマ区切りのリストを指定します。 出口クラスは、このリストで指定された順序で呼び出されます。 詳しくは、 MFT agent.properties ファイルを参照してください。
  5. オプションで、 protocolBridgePropertiesConfiguration プロパティーを指定できます。 このプロパティーに指定した値は、protocolBridgePropertiesExitClasses によって指定された出口クラスの initialize() メソッドにストリングとして渡されます。 詳しくは、 MFT agent.properties ファイルを参照してください。