What is installed for IBM MQ classes for Java

The latest version of IBM® MQ classes for Java is installed with IBM MQ. You might need to override default installation options to make sure this is done.

For more information about installing IBM MQ see:

IBM MQ classes for Java are contained in the Java archive (JAR) files, com.ibm.mq.jar, and com.ibm.mq.jmqi.jar.

Support for standard message headers, such as Programmable Command Format (PCF), is contained in the JAR file com.ibm.mq.headers.jar.

Support for Programmable Command Format (PCF) is contained in the JAR file com.ibm.mq.pcf.jar.

Note: It is not recommended to use the IBM MQ classes for Java within an application server. For information about the restrictions that apply when running in this environment, see Running IBM MQ classes for Java applications within Java EE. For more information, see Using WebSphere MQ Java Interfaces in J2EE/JEE Environments.

Important: Apart from the two relocatable JAR files described in this topic, copying the IBM MQ classes for Java JAR files or native libraries to other machines, or to a different location on a machine where the IBM MQ classes for Java have been installed, is not supported. In addition to this, including the com.ibm.mq.allclient.jar file, or the IBM MQ classes for Java, within application archives (such as enterprise application archives, or EAR files), is not supported.

The JSON4J.jar file and com.ibm.msg.client.mqlight package are not needed by the IBM MQ classes for Java and IBM MQ classes for JMS. From Version 8.0.0, Fix Pack 7, the following changes are therefore made to the com.ibm.mq.allclient.jar file :

The reference to JSON4J.jar file is removed from the class path statement within the manifest file for the com.ibm.mq.allclient.jar file.
The package com.ibm.msg.client.mqlight is no longer included inside the com.ibm.mq.allclient.jar file.

Relocatable JAR files

Within an enterprise, the following files can be moved to systems that need to run IBM MQ classes for Java applications:

com.ibm.mq.allclient.jar
com.ibm.mq.traceControl.jar

The file com.ibm.mq.allclient.jar contains the IBM MQ classes for JMS, the IBM MQ classes for Java, and the PCF and Headers Classes. If you move this file to a new location, make sure that you take steps to keep this new location maintained with new IBM MQ Fix Packs. Also, make sure that the use of this file is made known to IBM Support if you are getting an interim fix.

To determine the version of the com.ibm.mq.allclient.jar file, use the command:


java -jar com.ibm.mq.allclient.jar

The following example shows some sample output from this command:


C:\Program Files\IBM\WebSphere MQ_1\java\lib>java -jar com.ibm.mq.allclient.jar
Name:       Java Message Service Client
Version:    8.0.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/WebSphere MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       WebSphere MQ classes for Java Message Service
Version:    8.0.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/WebSphere MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       WebSphere MQ JMS Provider
Version:    8.0.0.0
Level:      p000-L140428.1 mqjbnd=p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/WebSphere MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       Common Services for Java Platform, Standard Edition
Version:    8.0.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/WebSphere MQ_1/java/lib/com.ibm.mq.allclient.jar

The com.ibm.mq.traceControl.jar file is used to dynamically control trace for IBM MQ classes for JMS applications.