MQSeries Publish/Subscribe Applications

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

2000.

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:

http://www.software.ibm.com/ts/mqseries/txppacs/

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

page 34.

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

directory.

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

Figure 4-8.

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

C:\MQ52\java\bin.

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.