Using IBM MQ classes for JMS in a CICS OSGi JVM server

IBM® MQ 8.0 added support for using the IBM MQ classes for JMS in certain versions of the CICS® Open Services Gateway initiative (OSGi) Java Virtual Machine (JVM) server.

Attention: Check the system requirements for the CICS system that your enterprise uses. See Detailed system requirements for CICS Transaction Server for detailed information.

This topic is an introduction on how to set up the IBM MQ classes for JMS in a JVM server environment.

See Using IBM MQ classes for JMS in an OSGi JVM server in theCICS documentation for details on setting up and configuring your system.

General restrictions

The following restrictions apply when using IBM MQ classes for JMS in a CICS OSGi JVM server:

Client mode connections are not supported.
Connections are only supported to IBM WebSphere® MQ 7.1, or IBM MQ 8.0 or later queue managers. The PROVIDERVERSION attribute on the connection factory must be either unspecified, or a value greater than, or equal to, seven.
Use of any of the XA connection factories, for example com.ibm.mq.jms.MQXAConnectionFactory, is not supported.
Use of IBM MQ classes for JMS in a CICS OSGi JVM server is only supported in CICS 5.2 or later. If you are using CICS 5.2, you must apply APAR PI32151.

[V9.0.1 Nov 2016] Before IBM MQ 9.0.1, using the IBM MQ classes for JMS in a Liberty JVM server environment is not supported.