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:

  1. 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:

    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:

  2. 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:

    . Set the following connector-specific properties:

  3. Configure the Port Connector Using Connector Configurator, set the following standard properties:
  4. 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 26 and set the Message Set ID to a unique value for each supported business object.

    Table 26. 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 27.

    Table 27. Supported sample business objects for Port connector

    Business object name Message ID
    Sample_WBIMB_LegacyItem 1
    Sample_WBIMB_LegacyItem_XMLDoc 2
  5. Create a new message flow project
    1. 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.
    2. Create a new Server Project and import all the files from the sample_folder/Sample_WBIMB_Project to your server project.
    3. 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.
  6. Configure connector start scripts


    Windows:

    1. Open the properties of the shortcut for the adapter for WebSphere Business Integration Message Broker.
    2. 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:

    1. 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
      

Copyright IBM Corp. 1997, 2004