ProtocolBridgePropertiesExit2:查閱通訊協定檔案伺服器內容

如果您有大量通訊協定檔案伺服器,則可以實作 com.ibm.wmqfte.exitroutine.api.ProtocolBridgePropertiesExit2 介面來查閱在傳送時參照的通訊協定檔案伺服器內容。 您可以實作此介面,這更勝於維護 ProtocolBridgeProperties.xml 檔。 Managed File Transfer 提供一個範例使用者結束程式,可查閱通訊協定檔案伺服器內容。

配置查閱通訊協定橋接器內容的使用者結束程式

關於此作業

任何查閱通訊協定橋接器內容的使用者結束程式都必須實作 com.ibm.wmqfte.exitroutine.api.ProtocolBridgePropertiesExit2 介面。 如需相關資訊,請參閱 ProtocolBridgePropertiesExit2.java 介面

您可以類似其他使用者結束程式的方式,將多個通訊協定伺服器內容結束程式鏈結在一起。 會根據在代理程式內容檔中使用 protocolBridgePropertiesExitClasses 內容指定的順序來呼叫結束程式。 個別傳回所有起始設定方法,如果有一個以上傳回 false 值,代理程式就不會啟動。 此錯誤報告於代理程式事件日誌中。

對所有結束程式的 getProtocolServerProperties 方法,只傳回一個整體結果。 如果該方法傳回內容物件作為結果碼,則此值是傳回的結果,且不會呼叫後續結束程式的 getProtocolServerProperties 方法。 如果該方法傳回空值作為結果碼,則會呼叫下一個結束程式的 getProtocolServerProperties 方法。 如果沒有後續的結束程式,則傳回空值結果。 出現空值的整體結果碼,代表通訊協定橋接器代理程式查閱失敗。

建議您使用 ProtocolBridgePropertiesExit2.java 介面,但如需 ProtocolBridgePropertiesExit.java 介面的相關資訊,請參閱 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 檔案

使用使用者結束程式範例

關於此作業

MQ_INSTALLATION_PATH/mqft/samples/protocolBridge 目錄及 範例通訊協定橋接器內容使用者結束程式主題中提供了查閱通訊協定橋接器內容的範例使用者結束程式。

SamplePropertiesExit2.java 結束程式會讀取包含通訊協定伺服器內容的內容檔。 此內容檔中每一個項目的格式如下所示:

serverName=type://host:port
內容檔的位置是從通訊協定橋接器代理程式內容 protocolBridgePropertiesConfiguration 取得。

若要執行使用者結束程式範例,請完成下列步驟:

程序

  1. 編譯 SamplePropertiesExit2.java 檔案。
  2. 建立包含已編譯結束程式及其套件結構的 JAR 檔。
  3. 將 JAR 檔放在 MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/bridge_agent/exits 目錄中。
  4. 編輯 MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/bridge_agent_name/agent.properties 檔案以包含下列行:
    
    protocolBridgePropertiesExitClasses=SamplePropertiesExit2
    
  5. MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/bridge_agent目錄中建立通訊協定橋接器內容檔,例如 protocol_bridge_properties.properties。 編輯此檔案,以併入此格式的項目:
    
    serverName=type://host:port
  6. 編輯 MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/bridge_agent/agent.properties 檔案以包含下列行:
    
    protocolBridgePropertiesConfiguration=MQ_DATA_PATH/mqft/config/coordination_queue_manager/
    agents/bridge_agent/protocol_bridge_properties.properties
    您必須使用 protocol_bridge_properties.properties 檔的絕對路徑。
  7. 使用 fteStartAgent 指令啟動通訊協定橋接器代理程式。