Set up the IMS bridge

The IBM MQ - IMS bridge is an optional component that enables IBM MQ to input and output to and from existing programs and transactions that are not IBM MQ-enabled.

This topic describes what we must do to customize the IBM MQ - IMS bridge.

    Define the XCF and OTMA parameters for IBM MQ.
    This step defines the XCF group and member names for the IBM MQ system, and other OTMA parameters. IBM MQ and IMS must belong to the same XCF group. Use the OTMACON keyword of the CSQ6SYSP macro to tailor these parameters in the system parameter load module.

    See Use CSQ6SYSP for more information.

    Define the XCF and OTMA parameters to IMS.
    This step defines the XCF group and member names for the IMS system. IMS and IBM MQ must belong to the same XCF group. Add the following parameters to your IMS parameter list, either in your JCL or in member DFSPBxxx in the IMS PROCLIB:

      OTMA=Y
      This starts OTMA automatically when IMS is started. (It is optional, if we specify OTMA=N we can also start OTMA by issuing the IMS command /START OTMA.)

      GRNAME=
      This parameter gives the XCF group name.

      It is the same as the group name specified in the storage class definition (see the next step), and in the Group parameter of the OTMACON keyword of the CSQ6SYSP macro.

      OTMANM=
      This parameter gives the XCF member name of the IMS system.

      This is the same as the member name specified in the storage class definition (see the next step).

    Tell IBM MQ the XCF group and member name of the IMS system.
    This is specified by the storage class of a queue. To send messages across the IBM MQ - IMS bridge we must specify this when you define the storage class for the queue. In the storage class, we must define the XCF group and the member name of the target IMS system. To do this, either use the IBM MQ operations and control panels, or use the IBM MQ commands as described in Introduction to Programmable Command Formats.

    Set up the security that you require.
    The /SECURE OTMA IMS command determines the level of security to be applied to every IBM MQ queue manager that connects to IMS through OTMA. See Security considerations for using IBM MQ with IMS for more information.


Adding an additional IMS connection to the same queue manager

To add an IMS connection to the same queue manager we must:

  • Define a second storage class STGCLASS to point at the new IMS; see DEFINE STGCLASS for more information.
  • Add a new local queue to point to the second storage class.

Important:

  • One local queue cannot point to two storage classes.
  • One storage class cannot point to two IMS bridges.
  • IBM MQ and IMS must belong to the same XCF group. Use the OTMACON keyword of the CSQ6SYSP macro to tailor these parameters in the system parameter load module.

    See Use CSQ6SYSP for more information.

Parent topic: Use IBM MQ with IMS


Related concepts


Related information