Set up the IMS adapter for use with IBM MQ classes for JMS

IBM MQ classes for JMS make use of the same IBM MQ-IMS adapter as used by other programming languages. This adapter uses the IMS External Subsystem Attach Facility (ESAF).

Before starting

Before completing the following procedure, we must configure the IMS adapter for the relevant queue managers, and IMS control and dependent regions, as described in Set up the IMS adapter.Attention: You do not need to perform the step that describes building a dynamic stub, unless we need the dynamic stub for other purposes.

Once you have configured the IMS adapter, carry out the following procedure.

Procedure

1. Update the LIBPATH variable in the member of our IMS PROCLIB that is referenced by the ENVIRON parameter in your dependent region JCL (for example, DFSJVMEV) so that it includes the IBM MQ classes for JMS native libraries. That is, the zFS directory that contains libmqjims.so. For example, DFSJVMEV might look like the following, where the last line is the directory containing the IBM MQ classes for JMS native libraries:

   LIBPATH=>
   /java/java71_31/J7.1/bin/j9vm:>
   /java/java71_31/J7.1/bin:>
   /ims13/dbdc/imsjava/classic/lib:>
   /ims13/dbdc/imsjava/lib:>
   /mqm/V8R0M0/java/lib
   

2. Add the IBM MQ classes for JMS to the class path of the JVM, used by your IMS dependent region, by updating the java.class.path option. Do this by following the instructions in DFSJVMMS member of the IMS PROCLIB data set. For example, we can use the following, where the line in bold indicates the update:

   -Djava.class.path=/ims13/dbdc/imsjava/imsutm.jar:/ims13/dbdc/imsjava/imsudb.jar:
   /mqm/V8R0M0/java/lib/com.ibm.mq.allclient.jarLIBPATH_SUFFIX=MQ_INSTALLATION_PATH

   Note: While there are many different jar files available in the directory containing the IBM MQ classes for JMS, we need only the com.ibm.mq.allclient.jar file.
3. Stop and restart the any IMS dependent regions that will be making use of the IBM MQ classes for JMS.

What to do next

Create and configure connection factories and destinations.

There are three possible approaches for instantiating the IBM MQ implementations of connection factories and destinations. See Create and configure connection factories and destinations in an IBM MQ classes for JMS applicationfor details.

Note that these three approaches are all valid in an IMS environment.

Parent topic: Use IBM MQ classes for JMS in IMS

Related information

• Set up the IMS adapter
• Defining IBM MQ to IMS