Setting up the IMS Synchronous Request sample

The sample uses the DSPALLI transaction, which is an IMS sample transaction that is typically installed on an IMS system. Check with your system administrator that it is installed before you try to use this sample. To set up the sample, perform the following steps:

1. Import and deploy the sample. The following directories are added to the workspace:
   • IMSSyncRequestSampleFlowProject. This directory contains one main sample flow, two subflows, and two .mbtest files. This project also contains a broker archive (BAR) file that contains a compiled message flow and all the message sets that are imported.
   • IMSSyncRequestSampleXMLMessageSet. This project contains the message set for parsing the XML messages that are sent to the flow by WebSphere MQ.
   • IMSSyncRequestSampleCWFMessageSet. This project contains the message set for parsing the binary messages that are sent and received from IMS.
2. By default, this sample deploys the following objects to the IMSSyncRequestSampleExecutionGroup execution group:
   • IMSSyncRequestSample message flow
   • IMSSyncRequestSampleXMLMessageSet
   • IMSSyncRequestSampleCWFMessageSet
3. The sample contains preset connection details and security credentials to connect to the local host on port 9999 with a blank user name and password. You must replace these values with the connection details for an IMS system that has IMS Connect running. The following values are required and must be changed in the BAR file for the sample:
   • The host name on which IMS Connect is running.
   • The port number on which IMS Connect is listening.
   • The data store that IMS Connect has defined to route requests to the correct IMS system.
   • The user name and password. You can set up IMS Connect so that it does not require either of these values. Check with your IMS system administrator to find out what security details you require.
4. To change the connection details and security credentials, complete the following steps:
   1. Create a security identity for IMS on the default integration node (which was created in step 1):

      mqsistop IB9NODE

      mqsisetdbparms IB9NODE -n ims::ims_sample_user -u <valid user name> -p <password for user>

      mqsistart IB9NODE

   2. Open the BAR file in the IMSSyncRequestSampleFlowProject project and change the IMSRequest node properties to the correct values for your system (circled in red in the following diagram):

   3. Redeploy the BAR file to the IMSSyncRequestSampleExecutionGroup execution group.

You can now run the sample, see Running the IMS Synchronous Request sample.

For an overview of how these nodes work and are configured, see IBM Information Management System (IMS) in the IBM Integration Bus documentation.

Back to sample home