Using the IBM MQ resource adapter
The resource adapter allows applications that are running in an application server to access IBM® MQ resources. It supports inbound and outbound communication.
What the resource adapter contains
The Java Platform, Enterprise Edition ( Java EE) Connector Architecture (JCA) provides a standard way of connecting applications that are running in a Java EE environment to an Enterprise Information System (EIS) such as IBM MQ or Db2®. The IBM MQ resource adapter implements the JCA 1.7 interfaces and contains the IBM MQ classes for JMS. It allows JMS applications and message driven beans (MDBs), running in an application server, to access the resources of an IBM MQ queue manager. The resource adapter supports both the point-to-point domain and the publish/subscribe domain.
- Outbound communication
- An application starts a connection to a queue manager, and then sends JMS messages to JMS destinations and receives JMS messages from JMS destinations in a synchronous manner.
- Inbound communication
- A JMS message that arrives at a JMS destination is delivered to an MDB, which processes the message asynchronously.
The resource adapter also contains the IBM MQ classes for Java. The classes are automatically available to applications that are running in an application server that the resource adapter has been deployed into, and allow applications that are running in that application server to use the IBM MQ classes for Java API when they are accessing resources of an IBM MQ queue manager.
The use of the IBM MQ classes for Java within a Java EE environment is supported with restrictions. For information about these restrictions, see Running IBM MQ classes for Java applications within Java EE.
Which version of the resource adapter to use
- Java EE 7
- The IBM MQ 8.0 resource adapter supports JCA v1.7 and provides JMS 2.0 support. This resource adapter needs to be deployed within a Java EE 7 and later application server (see IBM MQ resource adapter statement of support).
- Java EE 5 and Java EE 6
- The IBM WebSphere MQ 7.5 resource adapter supports Java EE Connector Architecture (JCA) v1.5 and provides JMS 1.1 support. To provide full integration with WebSphere Application Server Liberty, the IBM WebSphere MQ 7.5 resource adapter is updated to APAR IC92914 from Version 7.5.0, Fix Pack 2. This resource adapter retains full compatibility with other Java EE 5 and later application servers (see WebSphere MQ resource adapter v7.1 and later statement of support).
Using the resource adapter with the WebSphere Application Server full profile
Since the IBM MQ 8.0 resource adapter can be deployed only into an application server that supports JMS 2.0, do not install the Version 8.0 resource adapter into the application server if you are using WebSphere Application Server 7.0, Version 8.0 or Version 8.5 (on any platform). This is because WebSphere Application Server 7.0, Version 8.0 and Version 8.5 only support JMS 1.1. You must therefore use the IBM WebSphere MQ 7.0 resource adapter. This is the version of the resource adapter that comes with WebSphere Application Server 7.0, Version 8.0, and Version 8.5 and which can be used to connect to an IBM MQ 8.0 queue manager using either the BINDINGS or CLIENT transport.
Using the resource adapter with the WebSphere Application Server Liberty profile
To connect to IBM MQ from the WebSphere Application Server Liberty Liberty profile, you must use the IBM MQ resource adapter. Since the Liberty profile does not contain the IBM MQ resource adapter, you must obtain it separately from Fix Central. The version of the resource adapter that you use depends on the Java EE version of the application server.
For more information about how to download and install the resource adapter, see Obtaining the IBM MQ Resource Adapter for the WebSphere Application Server Liberty Profile.