This fictitious scenario involves two trading partner companies ("IBM
Corporation" and "IBM Trading Partner") that will be exchanging order
information. IBM Corporation (IBM) is using the TPI Adapter
with WebSphere MQ Integrator Broker to exchange XML documents between itself
and its trading partner named IBM Trading Partner (IBMTP).
There are two parts included in this sample scenario. Each is
designed to handle one direction of message exchange. For the first,
the WebSphere MQ Integrator Broker will place an event onto an MQ Series queue
for the Adapter for TPI to read. The adapter will convert the message
into an XML document using the XML DataHandler and send the document to the
IBM Trading Partner.
The second part requires the IBM Trading Partner company to send
an XML document to the IBM Corporation company. The TPI
Adapter located at IBM Corporation will convert the XML document
into an MQ Series message and place the message on an MQ Series queue for the
WebSphere MQ Integrator Broker to read.
- Note:
- In this sample, a real WebSphere MQ Integrator Broker will not be
used. The TPI Adapter is simply going to read and write from MQ Series
queues. The Visual Test Connector will be used to simulate the
WebSphere MQ Integrator Broker.
- Set up IBM Corporation TPI server:
- Start the TPI Administrator Tool on the IBM machine.
- From the Company Profiles tab, import the company profile from the
file:
%CROSSWORLDS%\connectors\TPI\samples\WebSphereMQIntegratorBroker
\IBM\IBMCorporation_company.xml.
- Leave the import password blank.
- Also from the Administrator Tool, click on the partners tab, and import
the partner profile from the file:
%CROSSWORLDS%\connectors\TPI\samples\
WebSphereMQIntegratorBroker\IBM\IBMTradingPartner_partner.xml.
- The company id for this TPI Server will be IBM
- Set up IBM Trading Partner TPI server:
- Start the TPI Administrator Tool on the IBMTP machine.
- From the Company Profiles tab, import the company profile from the
file:
%CROSSWORLDS%\connectors\TPI\samples\WebSphereMQIntegratorBroker\
IBMTP\IBMTradingPartner_company.xml.
- Also from the Administrator Tool, click on the partners tab, and import
the partner profile from the file:
%CROSSWORLDS%\connectors\TPI\samples\
WebSphereMQIntegratorBroker\IBMTP\IBMCorporation_partner.xml.
- The company id for this TPI Server will be IBMTP.
- Set up MQ Series:
- Create and start an MQ Series queue manager with a running channel
initiator and listener.
- Create the following named queues:
- ADMININQUEUE
- ADMINOUTQUEUE
- DELIVERYQUEUE
- FAULTQUEUE
- REQUESTQUEUE
- Open the start_TPIfile located in the
%CROSSWORLDS%\connectors\TPI directory. Change the
CYCLONEHOMEDIR value to the TPI home directory path. Save
and close the file.
- Configure the TPI Adapter and the Port Connector CFG file:
- Open the %CROSSWORLDS%\connectors\TPI\samples\
WebSphereMQIntegratorBroker\TPIConnector.cfg file.
- The following properties in the file may need to be modified for your
particular setup. See the User Guide for the IBM WebSphere Business
Integration Adapter for TPI for detailed information. If the property
represents a path or filename and it does not already exist, it needs to be
created.
- Open the %CROSSWORLDS%\connectors\TPI\samples\
WebSphereMQIntegratorBroker\PortConnector.cfg file. The
following properties in the file may need to be modified for your particular
setup. If the property represents a path or filename and it does not
already exist, it needs to be created.
-
QueueManager
-
RepositoryDirectory
- Specify the TPI Adapter CFG file:
- For Windows: Open the properties of the shortcut for the TPI
Adapter. As the last argument in the target, add "-c" + <full path
and filename for the TPIConnector.cfg file>
- For example: -c%CROSSWORLDS%\connectors\TPI\Samples\
WebSphereMQIntegratorBroker\IBM\TPIConnector.cfg
- For UNIX: Open the
${CROSSWORLDS}/bin/connector_manager_TPI file. Set the value
of the AGENTCONFIG_FILE property to "-c" + <full path and
filename for the TPIConnector.cfg file>
- AGENTCONFIG_FILE=-c${CROSSWORLDS}/connectors/TPI/samples/
WebSphereMQIntegratorBroker/IBM/TPIConnector.cfg
