Customizing the IMS bridge

 

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

This chapter describes what you have to do to customize the WebSphere MQ-IMS bridge. The bridge is described in the WebSphere MQ for z/OS Concepts and Planning Guide.

Define the XCF and OTMA parameters for WebSphere MQ.

This step defines the XCF group and member names for your WebSphere MQ system, and other OTMA parameters. WebSphere 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 Using CSQ6SYSP for information about this.

Define the XCF and OTMA parameters to IMS.

This step defines the XCF group and member names for the IMS system. IMS and WebSphere 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. (This is optional, if you specify OTMA=N we can also start OTMA by issuing the IMS command /START OTMA.)

GRNAME=

This gives the XCF group name.

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

USERVAR=

This 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).

If you do not specify a name for USERVAR, the value of APPLID1 is used.

Tell WebSphere 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 WebSphere MQ-IMS bridge we need to specify this when you define the storage class for the queue. In the storage class, we need to define the XCF group and the member name of the target IMS system. To do this, either use the WebSphere MQ operations and control panels, or use the WebSphere MQ commands as described in the WebSphere MQ Script (MQSC) Command Reference manual.

Set up the security that you require.

The

/SECURE OTMA IMS command determines the level of security to be applied to every WebSphere MQ queue manager that connects to IMS through OTMA. See Security considerations for the IMS bridge for information about what this should be set to.