Obtaining the IBM MQ classes for JMS separately

The IBM® MQ classes for JMS are available within a self-extracting JAR file that you can download from Fix Central if you want to obtain just the IBM MQ classes for JMS JAR files, for deployment into a software management tool, or to use with stand-alone client applications.

1. Download the IBM MQ Java JAR file from Fix Central.
   To locate the latest version that is available for download, enter the phrase "Java" in the Text Search box. The name of the file to be downloaded is in the format V.R.M.F-WS-MQ-Install-Java-All.jar where V.R.M.F is the product version number, for example 8.0.0.2.

   If you cannot find the file, make sure that Product Selected is WebSphere MQ and Version is 8.0.

2. Start the installation from the directory to which you downloaded the file.
   To start the installation, enter a command in the following format:

   java -jar V.R.M.F-WS-MQ-Install-Java-All.jar

   where V.R.M.F is the product version number, for example 8.0.0.2, and V.R.M.F-WS-MQ-Install-Java-All.jar is the name of the file that was downloaded from Fix Central.
   For example, to install the IBM MQ classes for JMS for the Version 8.0.0, Fix Pack 2 release, you would use the following command:

   java -jar 8.0.0.2-WS-MQ-Install-Java-All.jar

   Note: To carry out this installation, you must have a JRE installed on your machine and added to the system path.

   When you enter the command, the following information is displayed:

   Before you can use, extract, or install IBM WebSphere MQ V8.0, you must accept
   the terms of 1. IBM International License Agreement for Evaluation of
   Programs 2. IBM International Program License Agreement and additional
   license information. Please read the following license agreements carefully.
   
   The license agreement is separately viewable using the
   --viewLicenseAgreement option.
   
   Press Enter to display the license terms now, or 'x' to skip.

3. Review and accept the license terms:
   1. To display the license, press Enter.
      Alternatively, pressing x skips the display of the license.
      After the license is displayed, or immediately if you select x, the following message is displayed:

      Additional license information is separately viewable using the
      --viewLicenseInfo option.
      
      Press Enter to display additional license information now, or 'x' to skip.

   2. To display the additional license terms, press Enter.
      Alternatively, pressing x skips the display of the additional license terms.
      After the additional license terms are displayed, or immediately if you select x, the following message is displayed:

      By choosing the "I Agree" option below, you agree to the terms of the
      license agreement and non-IBM terms, if applicable. If you do not
      agree, select "I do not Agree".
      
      Select [1] I Agree, or [2] I do not Agree:

   3. To accept the license agreement and continue with selecting the installation directory, select 1.
      Alternatively, selecting 2 ends the installation immediately.
      If you select 1, the following message appears:

      Enter directory for product files or leave blank to accept the default value.
      The default target directory is H:\WMQ
      
      Target directory for product files?

4. Specify the installation directory for the resource adapter:
   • If you want to install the product files in the default location, press Enter without specifying a value.
   • If you want to install the product files in a different location from the default, specify the name of the directory in which you want to install the product files, and then press Enter to start the installation.
   The directory name that you specify must not already exist, otherwise, when you start the installation, an error is reported and no files are installed.
   Provided that it does not already exist, the selected installation directory is created and the program files are installed in this directory. During the installation, a new directory with the name wmq is created within the installation directory that you selected. Three subdirectories, JavaEE, JavaSE, and OSGi, are created in the wmq directory with the following contents:

   .\JavaEE:
   wmq.jmsra.ivt.ear 
   wmq.jmsra.rar
   
   .\JavaSE:
   com.ibm.mq.allclient.jar 
   com.ibm.mq.traceControl.jar 
   fscontext.jar 
   jms.jar 
   providerutil.jar
   
   .\OSGi:
   com.ibm.mq.osgi.allclient_<V.R.M.F>.jar 
   com.ibm.mq.osgi.allclientprereqs_<V.R.M.F>.jar

   Before IBM MQ 8.0.0, Fix Pack 9, the files that are installed in the JavaSE directory include the JSON4J.jar file. However, this JAR file is not required, and is therefore removed from the V.R.M.F-WS-MQ-Install-Java-All.jar file from Version 8.0.0, Fix Pack 9. Also, from Version 8.0.0, Fix Pack 9, there are two changes 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.

   When the installation is complete, a confirmation message is displayed as shown in the following example:

   Extracting files to H:\WMQ\wmq
   Successfully extracted all product files.