本主題包含設定環境的概觀及程序。
本節說明如何準備環境來使用指導教學。 在後續內容中,sample_folder
是指已安裝之檔案結構中的 samples/Legacy Item
資料夾。如需進一步資訊,請參閱驗證安裝。sample_folder
中提供了商業物件儲存庫:.xsd 檔案。
指導教學會描述 WebSphere Business Integration Message Broker 配接器與
「視覺化測試連接器」之間的簡式商業物件交換。 交換是在 WebSphere Business
Integration Message Broker 環境中發生。
若要針對指導教學來設定,請配置下列各項:
- 定義佇列指導教學必須在佇列管理程式中定義八個佇列。
若要建立必要的佇列,請在指令行中鍵入 RUNMQSC,並發出下列指令:
- DEFINE QL('Samples/WBIMB/Item/LegacyApp')
- DEFINE QL('Samples/WBIMB/Item/WBIMBConnector')
- DEFINE QL('Samples/LegacyApp/Item/WBIMB')
- DEFINE QL('Samples/WBIMBConnector/Item/WBIMB')
- DEFINE QL('Samples/WBIMB/FAIL')
- DEFINE QL('Samples/WBIMBConnector/UNSUBSCRIBED')
- DEFINE QL('Samples/WBIMBConnector/ERROR')
- DEFINE QL('Samples/WBIMBConnector/ARCHIVE')
之後您就可以為 WBI Message Broker 配置定義 WBI Message Broker
配接器及「埠」 連接器所需的佇列,如下所示:
- DEFINE QL('WBIMBConnector/ADMININQUEUE')
- DEFINE QL('WBIMBConnector/ADMINOUTQUEUE')
- DEFINE QL('WBIMBConnector/DELIVERYQUEUE')
- DEFINE QL('WBIMBConnector/FAULTQUEUE')
- DEFINE QL('WBIMBConnector/REQUESTQUEUE')
- DEFINE QL('WBIMBConnector/RESPONSEQUEUE')
- DEFINE QL('WBIMBConnector/SYNCHRONOUSREQUESTQUEUE')
- DEFINE QL('WBIMBConnectorSYNCHRONOUSRESPONSEQUEUE')
- DEFINE QL('WBIMBConnectorMONITORQUEUE')
- DEFINE QL('PortConnector/ADMININQUEUE')
- DEFINE QL('PortConnector/ADMINOUTQUEUE')
- DEFINE QL('PortConnector/DELIVERYQUEUE')
- DEFINE QL('PortConnector/FAULTQUEUE')
- DEFINE QL('PortConnector/REQUESTQUEUE')
- DEFINE QL('PortConnector/RESPONSEQUEUE')
- DEFINE QL('PortConnector/SYNCHRONOUSREQUESTQUEUE')
- DEFINE QL('PortConnector/SYNCHRONOUSRESPONSEQUEUE')
- 配置配接器使用連接器配置程式, 選取檔案 ->
開啟 -> 從檔案,並載入 sample_folder 中的
WBIMBConnector.cfg。
檢查或變更配接器配置內容,使其與下列值相符。
如需使用「連接器配置程式」的進一步資訊,請參閱配置資料處理常式;如需連接器特有內容的詳細資訊, 請參閱附錄 B, WBI Message Broker 配接器的連接器特有內容。
請參閱下列標準內容:
- 分配管理系統類型將這個內容設為 WMQI。
- 儲存庫目錄將這個內容設為 sample_folder 資料夾。
- DuplicateEventElimination 將這個內容設為 true。
- MonitorQueue 將這個內容設為
WBIMBConnector/MONITORQUEUE。
請設定下列連接器特有內容:
- ConfigurationMetaObject 將這個內容設為
Sample_WBIMB_MO_Config。
- DataHandlerConfigMO 將這個內容設為
Sample_WBIMB_MO_DataHandler。
- DataHandlerMimeType 將這個內容設為 text/xml。
- ErrorQueue
將這個內容設為queue://crossworlds.queue.manager/Samples/WBIMBConnector/ERROR。
- InputQueue 將這個內容設為
queue://crossworlds.queue.manager/Samples/WBIMB/Item/WBIMBConnector。
- UnsubscribedQueue 將這個內容設為
queue://crossworlds.queue.manager/Samples/WBIMBConnector/UNSUBSCRIBED。
- ArchiveQueue 將這個內容設為
queue://crossworlds.queue.manager/Samples/WBIMBConnector/ARCHIVE
- 配置埠連接器使用連接器配置程式, 設定下列標準內容:
- 分配管理系統類型將這個內容設為 WMQI。
- 儲存庫目錄將這個內容設為 sample_folder 資料夾。
- RequestQueue 將這個內容設為
WBIMBConnector/DELIVERYQUEUE (WBI Message Broker 配接器的
DeliveryQueue 內容值)。
- DeliveryQueue 將這個內容設為
WBIMBConnector/REQUESTQUEUE (WBI Message Broker 配接器的
RequestQueue 內容值)。
- 配置支援的商業物件若要使用商業物件,則配接器必須先加以支援。
您可使用連接器配置程式,按一下 WBI Message Broker 配接器的
支援的商業物件標籤,新增商業物件 (如表 26 所示),然後針對每個支援的商業物件, 將訊息集
ID 設為唯一值。
表 26. JMS 配接器支援的範例商業物件
商業物件名稱
| 訊息 ID
|
Sample_WBIMB_MO_Config
| 1
|
Sample_WBIMB_MO_DataHandler
| 2
|
Sample_WBIMB_LegacyItem
| 3
|
Sample_WBIMB_LegacyItem_XMLDoc
| 4
|
使用連接器配置程式,開啟 sample_folder 中提供的
「埠」連接器定義
PortConnector.cfg,然後新增支援的商業物件及「訊息 ID」, 如表 27 所示。
表 27. 「埠」連接器支援的範例商業物件
商業物件名稱
| 訊息 ID
|
Sample_WBIMB_LegacyItem
| 1
|
Sample_WBIMB_LegacyItem_XMLDoc
| 2
|
- 建立新訊息流程專案
- 開啟訊息分配管理系統工具箱,並建立新的
訊息流程專案。將所有訊息流程及 ESQL 檔案從
sample_folder/MSG_FLOW_PROJECT
目錄匯入您的「訊息流程專案」。
- 建立新的伺服器專案,並將所有檔案從
sample_folder/Sample_WBIMB_Project 匯入您的伺服器專案。
- 連接到分配管理系統管理視景之網域概略表下顯示的網域。
從分配管理系統管理視景的
分配管理系統管理瀏覽器畫面中,將 bar 檔
Sample_WBIMB_bar.bar 部署為分配管理系統的預設執行群組。
- 配置連接器啟動 Script
Windows:
- 開啟 WBI Message Broker 配接器的捷徑內容。
- 新增 -c,後面跟著 <WBIMBConnector.cfg
檔案的完整路徑及檔案名稱>,作為目標的最後一個引數。例如:
-cProduct_Dir\connectors\WBIMB\LegacyItem\
WBIMBConnector.cfg
UNIX:
- 開啟檔案:Product_Dir/bin/connector_manager_WebSphereBusinessIntegrationMessageBroker。將
AGENTCONFIG_FILE 內容的值設為 -c,後面跟著
<WBIMBConnector.cfg 檔案的完整路徑及檔案名稱>。 例如:
AGENTCONFIG_FILE=-cProduct_Dir/connectors/
WebSphereBusinessIntegrationMessageBroker/samples/LegacyItem/WBIMBConnector.cfg
