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 you 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 your 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 you 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. If you want to send messages across the IBM MQ - IMS bridge you must specify this when you define the storage class for the queue. In the storage class, you 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.