What is installed

The latest versions of both WebSphere MQ base Java and WebSphere MQ JMS (together known as WebSphere MQ Java) are installed with WebSphere MQ. You might need to override default installation options to make sure this is done.

WebSphere MQ base Java is contained in:

com.ibm.mq.jar Includes support for all the connection options.
com.ibm.mqbind.jar Supports only the bindings connection and is not supplied or supported on all platforms. We recommend that you do not use it in any new applications.

 

WebSphere MQ JMS is contained in com.ibm.mqjms.jar

The following Java libraries from Sun Microsystems are distributed with the WebSphere MQ JMS product:

connector.jar Version 1.0
fscontext.jar Version 1.2 Beta 3
jms.jar Version 1.0.2
jndi.jar Version 1.2.1 (except for z/OS and OS/390)
ldap.jar Version 1.2.2 (except for z/OS and OS/390)
providerutil.jar Version 1.2
jta.jar Version 1.0.1

When installation is complete, files and samples are installed in the locations shown in Installation directories.

Inlude postcard.jar if you want to run JMS Postcard.

After installation, update environment variables.

Do not install the product, then subsequently install or reinstall a version of SupportPac MA88, or your WebSphere MQ Java support might revert to an earlier level.

 

Installation directories

Platform Directory
AIX /usr/mqm/java/
z/OS and OS/390 install_dir/mqm/java/
iSeries and AS/400(R) /QIBM/ProdData/mqm/java/
HP-UX and Solaris /opt/mqm/java/
Linux /opt/mqm/java/
Windows systems \Program Files\IBM\WebSphere MQ\java

Some sample programs, such as the Installation Verification Programs (IVP), are supplied. WebSphere MQ base Java samples are within a subdirectory base and WebSphere MQ JMS samples are within a subdirectory jms.

Platform Directory
AIX /usr/mqm/samp/java/
HP-UX and Solaris /opt/mqm/samp/java/
Linux /opt/mqm/samp/java/
Windows systems \Program Files\IBM\WebSphere MQ\tools\Java\

 

Environment variables

After installation, update your CLASSPATH environment variable to include the WebSphere MQ base Java code and samples directories.

WebSphere MQ Java uses other environment variables. Some are platform dependent. MQ_JAVA_INSTALL_PATH and MQ_JAVA_DATA_PATH are common across platforms. On Windows systems, these variables are automatically set by the installation program, but on other platforms you need to set them manually to complete installation.

MQ_JAVA_INSTALL_PATH points to the product installation directory. MQ_JAVA_DATA_PATH points to the root directory for logging and tracing, and is included so that you can use the same directory for WebSphere MQ Java and the base WebSphere MQ product.

Platform Sample CLASSPATH
AIX CLASSPATH=
/usr/mqm/java/lib/com.ibm.mq.jar:
/usr/mqm/java/lib/connector.jar:
/usr/mqm/samp/java/base:
HP-UX and
Solaris
CLASSPATH=
/opt/mqm/java/lib/com.ibm.mq.jar:
/opt/mqm/java/lib/connector.jar:
/opt/mqm/samp/java/base:
Linux CLASSPATH
/opt/mqm/java/lib/com.ibm.mq.jar:
/opt/mqm/java/lib/connector.jar:
/opt/mqm/samp/java/base:

To use WebSphere MQ JMS, include additional jar files in the classpath. These are listed in Post installation setup.

If there are existing applications with a dependency on the deprecated bindings package com.ibm.mqbind, also add the file com.ibm.mqbind.jar to your classpath.

You must update additional environment variables on some platforms.

Platform Environment variable
AIX LD_LIBRARY_PATH=/usr/mqm/java/lib
HP-UX SHLIB_PATH=/opt/mqm/java/lib
Solaris LD_LIBRARY_PATH=/opt/mqm/java/lib
Windows systems PATH=install_dir\lib
Linux LD_LIBRARY_PATH=/opt/mqm/java/lib

Notes:

  1. To use WebSphere MQ Bindings for Java on OS/400, ensure that the library QMQMJAVA is in your library list.

  2. Ensure that you append the WebSphere MQ variables and do not overwrite any of the existing system environment variables. If you overwrite existing system environment variables, the application might fail during compilation or at runtime.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.

 

AIX is a trademark of the IBM Corporation in the United States, other countries, or both.