What is installed for IBM MQ classes for JMS

A number of files and directories are created when you install IBM® MQ classes for JMS. On Windows, some configuration is performed during installation by automatically setting environment variables. On other platforms, and in certain Windows environments, you must set environment variables before you can run IBM MQ classes for JMS applications.

For most operating systems, the IBM MQ classes for JMS are installed as an optional component when you install IBM MQ.

For more information about installing IBM MQ, see:
Important: Apart from the relocatable JAR files described in IBM MQ classes for JMS relocatable JAR files, copying the IBM MQ classes for JMS JAR files or native libraries to other machines, or to a different location on a machine where the IBM MQ classes for JMS have been installed, is not supported.

Installation directories

Table 1 shows where the IBM MQ classes for JMS files are installed on each platform.
Table 1. IBM MQ classes for JMS installation directories
Platform Directory
[AIX][Linux]AIX® and Linux® MQ_INSTALLATION_PATH/java
[Windows]Windows MQ_INSTALLATION_PATH\java
[IBM i]IBM i /QIBM/ProdData/mqm/java
[z/OS]z/OS MQ_INSTALLATION_PATH/mqm/V9R2M0/java

MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.

The installation directory includes the following content:
  • The IBM MQ classes for JMS JAR files, including the relocatable JAR files, which are in the MQ_INSTALLATION_PATH\java\lib directory.
  • The IBM MQ native libraries, which are used by applications that use the Java Native Interface.

    The 32-bit native libraries are installed into the MQ_INSTALLATION_PATH\java\lib directory and the 64-bit native libraries can be found in the MQ_INSTALLATION_PATH\java\lib64 directory.

    For more information about the IBM MQ native libraries, see Configuring the Java Native Interface (JNI) libraries.

  • Additional scripts that are described in Scripts provided with IBM MQ classes for JMS. These scripts are in the MQ_INSTALLATION_PATH\java\bin directory.
  • The specifications of the IBM MQ classes for JMS API. The Javadoc tool has been used to generate the HTML pages that contain the specifications of the API.
    The HTML pages are in the MQ_INSTALLATION_PATH\java\doc\WMQJMSClasses directory:
    • [AIX, Linux, Windows]On AIX, Linux, and Windows, this subdirectory contains the individual HTML pages.
    • [IBM i]On IBM i, the HTML pages are in a file called wmqjms_javadoc.jar.
    • [z/OS]On z/OS, the HTML pages are in a file called wmqjms_javadoc.jar.
  • Support for OGSi. OSGi bundles are installed in the java\lib\OSGi directory and described in Support for OSGi.
  • The IBM MQ resource adapter, which can be deployed into any Java Platform, Enterprise Edition 7 ( Java EE 7) compliant application server.

    The IBM MQ resource adapter is in the MQ_INSTALLATION_PATH\java\lib\jca directory; for more information, see Using the IBM MQ resource adapter

  • [Windows]On Windows, symbols that can be used for debugging are installed in the MQ_INSTALLATION_PATH\java\lib\symbols directory.

The installation directory also includes some files that belong to other IBM MQ components.

Sample applications

Some sample applications are supplied with IBM MQ classes for JMS. Table 2 shows where the sample applications are installed on each platform.
Table 2. Samples directories
Platform Directory
[AIX][Linux]AIX and Linux MQ_INSTALLATION_PATH/samp/jms
[Windows]Windows MQ_INSTALLATION_PATH\tools\jms
[IBM i]IBM i /QIBM/ProdData/mqm/java/samples/jms
[z/OS]z/OS MQ_INSTALLATION_PATH/mqm/V9R2M0/java/samples/jms

MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.

After installation, you might need to perform some configuration tasks to compile and run applications.

Setting environment variables for IBM MQ classes for JMS describes the classpath that is required to run simple IBM MQ classes for JMS applications. This topic also describes additional JAR files that need to be referenced in special circumstances and the environment variables that you must set to run the scripts that are provided with IBM MQ classes for JMS.

To control properties, such as tracing and logging of an application, you need to provide a configuration properties file. The IBM MQ classes for JMS configuration properties file is described in The IBM MQ classes for JMS configuration file.