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.
Installation directories
Platform | Directory |
---|---|
AIX® and Linux® | MQ_INSTALLATION_PATH/java |
Windows | MQ_INSTALLATION_PATH\java |
IBM i | /QIBM/ProdData/mqm/java |
z/OS | MQ_INSTALLATION_PATH/mqm/V9R2M0/java |
MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.
- 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:
- On AIX, Linux, and Windows, this subdirectory contains the individual HTML pages.
- On IBM i, the HTML pages are in a file called wmqjms_javadoc.jar.
- 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
- 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
Platform | Directory |
---|---|
AIX and Linux | MQ_INSTALLATION_PATH/samp/jms |
Windows | MQ_INSTALLATION_PATH\tools\jms |
IBM i | /QIBM/ProdData/mqm/java/samples/jms |
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.