Using WebSphere MQ Integrator Broker

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.

Installation of the sample scenario

  1. Set up IBM Corporation TPI server:
    1. Start the TPI Administrator Tool on the IBM machine.
    2. From the Company Profiles tab, import the company profile from the file: %CROSSWORLDS%\connectors\TPI\samples\WebSphereMQIntegratorBroker \IBM\IBMCorporation_company.xml.
    3. Leave the import password blank.
    4. 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.
    5. The company id for this TPI Server will be IBM
  2. Set up IBM Trading Partner TPI server:
    1. Start the TPI Administrator Tool on the IBMTP machine.
    2. From the Company Profiles tab, import the company profile from the file: %CROSSWORLDS%\connectors\TPI\samples\WebSphereMQIntegratorBroker\ IBMTP\IBMTradingPartner_company.xml.
    3. 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.
    4. The company id for this TPI Server will be IBMTP.
  3. Set up MQ Series:
    1. Create and start an MQ Series queue manager with a running channel initiator and listener.
    2. Create the following named queues:
      • ADMININQUEUE
      • ADMINOUTQUEUE
      • DELIVERYQUEUE
      • FAULTQUEUE
      • REQUESTQUEUE
  4. 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.
  5. Configure the TPI Adapter and the Port Connector CFG file:
    1. Open the %CROSSWORLDS%\connectors\TPI\samples\ WebSphereMQIntegratorBroker\TPIConnector.cfg file.
    2. 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.
      • QueueManager
         
      • RepositoryDirectory
         
      • TradingPartnerConfigurationFile
         
      • MetaEventDir
         
      • DocumentOutDir
         
      • ArchiveProcessedDocDir
         
    3. 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
         
  6. Specify the TPI Adapter CFG file:

Copyright IBM Corp. 1997, 2004