Programming with WebSphere MQ classes for JMS in the CICS WebSphere MQ environment

CICS® Java™ programs may invoke various functions provided by the IBM® WebSphere® MQ classes for JMS. The IBM WebSphere MQ classes for JMS form part of the JMS-compliant IBM WebSphere MQ offering.

From the perspective of the JMS specification, the WebSphere MQ classes for JMS treat a CICS JVM server as a Java EE compliant application server, that always has a JTA transaction in progress. In particular, the WebSphere MQ classes for JMS assume that they are running in an EJB container. This results in restrictions on the use of the JMS API in a CICS environment. For more details, see JMS API restrictions in the WebSphere MQ Version 8 product documentation.

Support is provided for using the classic (JMS 1.1) and simplified (JMS 2.0) interfaces, provided that CICS is connected to a level of WebSphere MQ queue manager that supports the appropriate level of JMS.

Support from WebSphere MQ using the WebSphere MQ classes for JMS is provided in WebSphere MQ for z/OS® 7.1 and version 8. Apply CICS TS 5.2 APAR PI32151 and the APAR for the version of WebSphere MQ you are using:

Version 7.1 apply fixpack 7.1.0.7 or any later fixpack level
Version 8 apply base APAR PI28482 and fixpack 8.0.0.4 or any later fixpack level