IBM Support

Java MQException Class moved to the file in MQ V7

Technote (FAQ)


Why was the Java™ MQException Class moved to the file in WebSphere MQ V7.0?


The move of the MQException class to the new was as a result of significant re-engineering that was implemented across the MQ classes for Java and the MQ classes for JMS. The JMS classes ( and Java classes ( are now independent and stand as peers, therefore the MQException Class was moved to a common JAR file that can be used by either the Java and JMS libraries.

In MQ V7, if you use Java 2 Software Development Kit (SDK) Version 1.5 or later (1.6, 1.7, etc). to compile your applications, it will read the manifest of and automatically pick up dependent JARs such as

However, if you compile your Java code using the SDK Version 1.4.2, you must add the following JAR files to your class path so that they will be picked up.

  • jms.jar

Therefore to avoid any problems associated with the this necessary class change, use Java 1.5 to compile your applications (for example, pointing Rational Application Developer or RAD), or if you are using Java 1.4, add the extra JAR files to the classpath used in compiling applications.

Additional information
See: Environment variables used by WebSphere MQ classes for JMS

Related information

A Japanese translation is available

Product Alias/Synonym

wmq mq

Document information

More support for: WebSphere MQ

Software version: 7.0, 7.1, 7.5

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1316673

Modified date: 10 February 2014