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 Commerce Suite server
- Open all files that start with icssvr.cfg (including
such files as icssvr.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\icssvr:
- inboxB
- inboxB/fromA
- inboxC
- inboxC/fromA
- noticesB
- noticesC
- receiptsB
- receiptsC
If these directories do not exist, please create them.
