This section describes how to prepare your environment to work
with the tutorial. In what follows, sample_folder refers to
the samples/WebSphereMQIntegratorBroker folder in which
the samples for this MQ Integrator Broker tutorial reside,
andWBI_folder refers to the folder containing your current
IBM WebSphere Business Integration installation.
- Create the queues Create and start a WebSphere MQ queue
manager with a running channel initiator and listener. Then create
the queues shown below using the createQueues.txt script.
To use the script, execute the following:
runmqsc wbia.queue.manager < createQueues.txt
Create the following queues:
- ADMININQUEUE
- ADMINOUTQUEUE
- DELIVERYQUEUE
- FAULTQUEUE
- REQUESTQUEUE
- RESPONSEQUEUE
- COMPA.TXT
- COMPA.XML
- COMPA.IN
- COMPA.OUT
- COMPA.NOTICES
- COMPA.RECEIPTS
- ISOFT.ARCHIVE
- ISOFT.ERROR
- ISOFT.IN_PROGRESS
- ISOFT.REPLY
- ISOFT.UNSUBSCRIBED
- ISOFTCONNECTOR/MONITORQUEUE
- ISOFTCONNECTOR/REQUESTQUEUE
- ISOFTCONNECTOR/RESPONSEQUEUE
- ISOFTCONNECTOR/SOURCEQUEUE
- ISOFTCONNECTOR/SYNCHRONOUSREQUESTQUEUE
- ISOFTCONNECTOR/SYNCHRONOUSRESPONSEQUEUE
- PORTCONNECTOR/SYNCHRONOUSREQUESTQUEUE
- PORTCONNECTOR/SYNCHRONOUSRESPONSEQUEUE
- Configure the standard properties for the iSoft and Port
connectors Open both
sample_folder\ISoftConnector.cfg and
sample_folder\PortConnector.cfg using Connector
Configurator. In both windows set the following Standard
Properties:
- jms.MessageBrokerName Set this property to the name of
your queue manager (default =wbia.queue.manager)
- RepositoryDirectory Set this property to
WBI_folder\connectors\ISoft\samples\WebSphereMQIntegratorBroker\repos
- PollFrequency Set this value to 10000 (UNIX
only - for Windows, leave value key)
- Configure connector-specific properties Open both
sample_folder\ISoftConnector.cfg and
sample_folder\PortConnector.cfg using Connector
Configurator. In both windows set the following connector-specific
Properties:
- Replace all instances of wbia.queue.manager with the
name of your queue manager (for both iSoft and Port
connectors)
- Set the following properties in the ISoftConnector.cfg
file only
- Set the hostname property to the name of your
machine.
- Set the port property to the port your queue manager
is listening on (default = 1414)
- Set the channel property to CHANNEL1
- Creating or updating connector start scripts
- FOR Windows:
- Create a new shortcut named START ISOFT CONNECTOR.
Right-click the shortcut and select the Shortcut tab.
- Set the Target text box to execute the adapter.
- The shortcut should execute the start_ISoft.bat file
and pass it three Command Line arguments:
- The name of the connector, which in this case is
ISoft
- The name of the broker, which you may create. For example,
iSoftSTA. In this example the adapter is running in
sandalone mode. No broker is used. Accordingly, this parameter's
value may contain any combination of alphanumeric characters.
- The string literal -c followed by the full path to the
XMLConnector.cfg file. For example:
cWBI_folder\connectors\ISoft\samples\WebSphereMQIntegratorBroker
\ISoftConnector.cfg
Here is a full example of a correctly set Target text box:
WBI_folder\connectors\ISoft\
start_ISoft.bat ISoft WMQIrm -cWBI_folder\connectors\ISoft\samples\
WebSphereMQIntegratorBroker\ISoftConnector.cfg
- Set the Start In text box value to
WBI_folder\connectors\ISoft
- Click OK.
- For UNIX
- Configure the meta-object If your WebSphere MQ Queue
Manager is not named wbia.queue.manager, you will need to
update URIs in attribute AppSpecificInfo fields in the
Sample_ISoft_MO_Config business object.
- Open the Sample_ISoft_MO_Config business object in
Business Object Designer. The file is located in the
WBI_folder/repos directory
- Scroll to the right and examine values in the AppSpecificInfo
column. Replace instances of wbia.queue.manager with the name of
your queue manager.
- Configure the iSoft Peer-to-Peer Agent
- Open all files that start with p2pagent.cfg (including
such files asp2pagent.cfg_a).
- Replace wbia.queue.manager with the name of your queue
manager.
- For UNIX, update the file separators in the configuration
files. Replace \ with / in addpair commands.
- Make sure that the following directories exist in the
sample_folder\p2pagent:
- inboxB
- inboxB/fromA
- inboxC
- inboxC/fromA
- noticesB
- noticesC
- receiptsB
- receiptsC
If these directories do not exist, please create them.
