Setting 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 utilizes the IMS External Subsystem Attach Facility (ESAF).

1. Update the LIBPATH variable in the member of your 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, you 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_ROOT>
   

   Note: While there are many different jar files available in the directory containing the IBM MQ classes for JMS, you 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.