32 MQSeries Publish/Subscribe Applications
Click Finish to confirm to terminate the installation as indicated in Figure 4-4.
Figure 4-4 Installation of Publish/Subscribe SupportPac (4 of 4)
You have now successfully installed MQSeries Publish/Subscribe for Windows
4.2.2 JMS installation
To work with JMS, we must install the Java classes that implement the JMS
interfaces defined by Sun. To make an analogy with databases, these classes
can be thought of as a driver, not a JDBC driver but a JMS driver. The JMS
classes for MQSeries are delivered in the free MA88 SupportPac. This
SupportPac contains the MQSeries classes for Java (MQI) and the MQSeries
classes for Java Messaging Service (JMS).
MA88 can be downloaded from the MQSeries internet URL:
You can download the appropriate version for your platform and install it
following the installation instructions provided with the SupportPac.
For Windows 2000, we download the file ma88_win, uncompress it and start the
setup.exe program. Figure 4-5 shows the welcome window of the installation.
Chapter 4. The publish/subscribe application 33
Figure 4-5 Installation of MA88 (1 of 4)
Click Next and choose between the Complete or the Custom installation.
Figure 4-6 Installation of MA88 (2 of 4)
34 MQSeries Publish/Subscribe Applications
Unless you have installed MQSeries using the default directories, you must
choose the Custom installation to specify the right directories where the new
Java classes should be installed. Even if you have installed MQSeries in the
default directory, we recommend that you choose the Custom option in order to
check the installation directory.
After clicking Next, you can choose which Java classes you want to install, the
MQSeries classes for Java or for JMS or both, as shown in Figure 4-7 on
Figure 4-7 Installation of MA88 (3 of 4)
In our case we install both MQSeries classes. If MQSeries is installed in the
default directory (for example C:\Program Files\IBM\MQSeries), you don’t need
to change the installation directory and can leave the default installation path (for
example C:\Program Files\IBM\MQSeries\Java\). However we recommend that
you check that the directory to which the Java classes will be installed
corresponds to the existing Java subdirectory in your MQSeries installation
If MQSeries has been installed into another directory, for instance C:\MQ52, then
you must change the installation directory to C:\MQ52\Java\ as shown in
Chapter 4. The publish/subscribe application 35
Figure 4-8 Installation of MA88 (4 of 4)
Click Next one last time and the MA88 SupportPac is installed automatically.
Once the installation has completed, and in order to run publish/subscribe
applications with JMS, you need to run an MQSC script, MQJMS_PSQ.mqsc, on
the queue manager that you are using to define the MQSeries queues required
for JMS in its publish/subscribe mode.
This script is located in the bin subdirectory of the directory where we installed
the MA88 SupportPac, for example C:\Program Files\IBM\MQSeries\Java\bin or
To run the script on the default queue manager, execute the following command:
runmqsc < "C:\Program Files\IBM\MQSeries\Java\bin\MQJMS_PSQ.mqsc"
where C:\Program Files\IBM\MQSeries is the MQSeries installation directory.
Note: During the installation of MA88, all the files present in the Java
subdirectory of the MQSeries installation directory are placed in a backup
directory and replaced with the new files contained in the SupportPac.
Therefore, it is important that the AMI SupportPac is installed only after the
installation of MA88. Otherwise, the JAR file containing the AMI Java classes
may no longer be found in the classpath environment variable after the
installation has completed.