This topic contains an overview and procedure for setting up your
environment.
This section describes how to prepare your environment to work with the
tutorial. In what follows, sample_folder refers to the
samples/Legacy Item folder in the installed file structure.
For further information, see Verifying installation. The business object repository is provided in the
sample_folder as .xsd files.
The tutorial depicts a simple business object exchange between the
WebSphere Business Integration Message Broker adapter and the Visual Test
Connector. The exchange occurs in a WebSphere Business Integration
Message Broker environment.
To set up for the tutorial, please configure the following:
- Define the
queues The tutorial requires that eight queues be defined in your queue
manager. To create the necessary queues, type RUNMQSC from a
command line and issue the following commands:
- 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')
Next you define the queues required by the WBI Message Broker adapter and
Port Connector for the WBI Message Broker configuration as follows:
- 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')
- Configure the adapter Using Connector Configurator,
select File->Open->From File and load the
WBIMBConnector.cfg in the sample_folder.
Check or change the adapter configuration properties to match the values
listed below. For further information on using Connector Configurator,
see Configuring a data handler; for more on connector-specific properties, see Appendix B, Connector-specific properties for the WBI Message Broker adapter.
Set the following
standard properties:
- Broker Type Set this property to WMQI.
- Repository Directory Set this property to the
sample_folder directory.
- DuplicateEventElimination Set this property to
true.
- MonitorQueue Set this property to
WBIMBConnector/MONITORQUEUE
. Set the following connector-specific properties:
- ConfigurationMetaObject Set this property to
Sample_WBIMB_MO_Config.
- DataHandlerConfigMO Set this property to
Sample_WBIMB_MO_DataHandler.
- DataHandlerMimeType Set this property to
text/xml.
- ErrorQueue Set this property to
queue://crossworlds.queue.manager/Samples/WBIMBConnector/ERROR.
- InputQueue Set this property to
queue://crossworlds.queue.manager/Samples/WBIMB/Item/WBIMBConnector.
- UnsubscribedQueue Set this property to
queue://crossworlds.queue.manager/Samples/WBIMBConnector/UNSUBSCRIBED.
- ArchiveQueue Set this property to
queue://crossworlds.queue.manager/Samples/WBIMBConnector/ARCHIVE
- Configure the Port Connector Using Connector
Configurator, set the following standard properties:
- Broker Type Set this property to WMQI.
- Repository Directory Set this property to the
sample_folder directory.
- RequestQueue Set this property to
WBIMBConnector/DELIVERYQUEUE (the DeliveryQueue property
value for the WBI Message Broker adapter).
- DeliveryQueue Set this property to
WBIMBConnector/REQUESTQUEUE (the RequestQueue property
value for the WBI Message Broker adapter).
- Configure supported business objects In order to use business
objects, adapters must first support them. Using Connector
Configurator, click the Supported Business Objects tab for
the WBI Message Broker adapter, add the business objects shown in Table 26 and set the Message Set ID to a unique value for
each supported business object.
Table 26. Supported sample business objects for JMS adapter
Business object name
| Message ID
|
Sample_WBIMB_MO_Config
| 1
|
Sample_WBIMB_MO_DataHandler
| 2
|
Sample_WBIMB_LegacyItem
| 3
|
Sample_WBIMB_LegacyItem_XMLDoc
| 4
|
Using Connector Configurator, open the Port connector
definition PortConnector.cfg provided in the
sample_folder, and add the supported business objects and Message
IDs shown in Table 27.
Table 27. Supported sample business objects for Port connector
Business object name
| Message ID
|
Sample_WBIMB_LegacyItem
| 1
|
Sample_WBIMB_LegacyItem_XMLDoc
| 2
|
- Create a new message flow project
- Open the Message Brokers Toolkit and create a new Message
Flow Project. Import all the message flows and ESQL files from
the sample_folder/MSG_FLOW_PROJECT directory to your
Message Flow Project.
- Create a new Server Project and import all the files from the
sample_folder/Sample_WBIMB_Project to your server
project.
- Connect to the domain displayed under the Domains view in your
Broker Administration perspective. Deploy the bar file
Sample_WBIMB_bar.bar from the Broker Administration
Navigator panel in your Broker Administration perspective to
the default execution group of your broker.
- Configure connector start scripts
Windows:
- Open the properties of the shortcut for the adapter for WBI Message
Broker.
- As the last argument in the target, add -c followed by the
<full path and filename for the WBIMBConnector.cfg
file> For example:
-cProduct_Dir\connectors\WBIMB\LegacyItem\
WBIMBConnector.cfg
UNIX:
- Open the file:
Product_Dir/bin/connector_manager_WebSphereBusinessIntegrationMessageBroker.
Set the value of the AGENTCONFIG_FILE property to -c
followed by the <full path and filename for the
WBIMBConnector.cfg file>. For example:
AGENTCONFIG_FILE=-cProduct_Dir/connectors/WebSphereBusinessIntegrationMessageBroker
/samples/LegacyItem/WBIMBConnector.cfg
