Setting up your environment
This topic contains an overview and procedure for setting
up your environment.
Overview of 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 ConnName/sample/LegacyItem 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.
Steps for setting up your 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 WebSphere Business Integration Message
Broker adapter and Port Connector for the WebSphere Business Integration
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 this 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 WebSphere Business Integration Message
Broker adapter).
- DeliveryQueue Set this property to WBIMBConnector/REQUESTQUEUE (the RequestQueue property value for the WebSphere Business Integration 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 WebSphere Business Integration Message Broker adapter, add
the business objects shown in Table 24 and
set the Message Set ID to a unique value for
each supported business object.
Table 24. 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 25.
Table 25. 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 WebSphere
Business Integration 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_WebSphereBIMessageBroker. 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=Product_Dir/connectors/
WebSphereBusinessIntegrationMessageBroker/
samples/LegacyItem/WBIMBConnector.cfg
