Installation of the sample scenario.

  1. Set up WebSphere MQ:

    First, create and start an WebSphere MQ queue manager with a running channel initiator and listener. Then create the following named queues:

    • ADMININQUEUE
    • ADMINOUTQUEUE
    • DELIVERYQUEUE
    • FAULTQUEUE
    • REQUESTQUEUE
  2. Configure XML connector and Port connector CFG file:

    Open the file: %WBIA_RUNTIME%\connectors\XML\samples\
    WebSphereMQIntegratorBroker\XMLConnector.cfg

    The following properties in the file may need to be modified for your particular setup. See the "Guide to the IBM WebSphere Business Integration Adapter for XML" for detailed information. If the property represents a path or filename that does not already exist, it needs to be created:

    • QueueManager
    • RepositoryDirectory
    • ArchiveDirectory

    Open the file: %WBIA_RUNTIME%\connectors\XML\samples\
    WebSphereMQIntegratorBroker\PortConnector.cfg

    The following properties in the file may need to be modified for your particular setup. If the property represents a path or filename that does not already exist, it needs to be created:

    • QueueManager
    • RepositoryDirectory
  3. Specifying the XML connector CFG file:
    • For NT/2000:

      Open the properties of the shortcut for the XML CONNECTOR. As the last argument in the target, add "-c" + <full path and filename for the XMLConnector.cfg file>.

      For example:

      c%WBIA_RUNTIME%\connectors\XML\samples\WebSphereMQIntegratorBroker\
      XMLConnector.cfg.
    • For UNIX:

      Open the file: ${WBIA_RUNTIME}/bin/connector_manager_XML. Set the value of the AGENTCONFIG_FILE property to "-c" + <full path and filename for the XMLConnector.cfg file>.

      For example:

      AGENTCONFIG_FILE=c${WBIA_RUNTIME}/connectors/XML/samples/
      WebSphereMQIntegratorBroker/XMLConnector.cfg.
  4. Modify the servlets for use in your envirnment

    The following changes must be made to the servlets:

    • For PollXMLOrder.java:

      On line 41 of the source file, the value of the outFileName String must be changed to be the name of the file on the local system to which the servlet should log the incoming XML message. On line 56 of the source file, the value passed to the FileInputStream constructor should be the exact file name on the local system for the delivered SamplePollingInput.xml file.

    • For MirrorXMLOrder.java:

      No Changes Necessary.

  5. Configure the XML Poll business object:

    Start the Business Object Designer. Select File->Open From File, and choose the file named "XML_POLL_Order.xsd". This will open the business object labeled "XML_POLL_Order". The first attribute of this business object should be named "URL". Change the URL attribute's default value to the location to which the XML Adapter will listen for XML responses (ie. PollXMLOrder.java). Save the business object by replacing the file XML_POLL_Order.xsd with the modified business object.

  6. Configure the web server:

    Compile the delivered servlets. The generated class files should be moved to the correct directory for the web server to pick them up and run them. Also, any additional steps to register the servlets should be done (the exact requirements will depend entirely on the web server being used).

Copyright IBM Corporation 1997, 2004. All Rights Reserved.