[Version 5.0.1 and later]Installing WebSphere MQ as the JMS provider

Use this task to install and configure WebSphere MQ with support for the Java Message Service (JMS) for use with the WebSphere Application Server.

Why and when to perform this task

To install and configure WebSphere MQ (MQSeries) for use as a JMS provider to IBM WebSphere Application Server, complete the following steps:

Steps for this task

  1. Install WebSphere MQ with the required MQ features, as described in the installation instructions provided with WebSphere MQ.

    If you are installing WebSphere MQ on top of WebSphere Application Server embedded messaging, perform the following actions when installing WebSphere MQ:

    1. When asked if you want to remove or modify the version of WebSphere MQ currently installed, choose to remove the Server. (The WebSphere MQ install program recognizes the installed WebSphere embedded messaging as an installed version of WebSphere MQ.)
    2. Select the option to keep existing queue managers.
    3. Proceed with the installation of the full WebSphere MQ Server by running the install program again, after the old WebSphere MQ server (the Embedded Messaging Server) has been removed.

    If you want to use the original WebSphere MQ release, ensure that you install the CSD04 update.

    If you want to use WebSphere MQ on the same machine as WebSphere Application Server embedded messaging, ensure that you install the following WebSphere MQ features:

    • For a WebSphere Application Server Embedded Messaging Server installation, the required MQ features are "Server" and "Java Messaging".
    • For a WebSphere Application Server Embedded Messaging Client installation, the only required MQ feature is "Java Messaging".

    For information about installing WebSphere MQ or migrating to WebSphere MQ from an earlier release, see the appropriate WebSphere MQ Quick Beginnings book, as listed above.

  2. If you want to use WebSphere MQ - Publish/Subscribe support, you need to provide a Publish/Subscribe broker.

    For example, you can do this by using either WebSphere Event Broker (formerly WebSphere MQ Event Broker) or WebSphere Message Broker (formerly WebSphere MQ Integrator).

    For more information about installing WebSphere Event Broker (formerly WebSphere MQ Event Broker) or WebSphere Message Broker (formerly WebSphere MQ Integrator), see the following Web sites:

  3. Follow the WebSphere MQ instructions for verifying your installation setup.
  4. For AIX, see the WebSphere MQ readme.txt for additional steps.
  5. If you want to install IBM WebSphere Application Server on the same host as WebSphere MQ, and have not yet done so, install and customize WebSphere Application Server.
    If you do not want to use the embedded WebSphere JMS provider, you can install WebSphere MQ then install WebSphere Application Server without the Embedded Messaging options.
  6. Set the MQJMS_LIB_ROOT environment variable to the directory where WebSphereMQ\Java\lib is installed.
    IBM WebSphere Application Server uses the MQJMS_LIB_ROOT to locate the WebSphere MQ libraries for the WebSphere MQ JMS Provider.

Results

This task has installed WebSphere MQ for use as the JMS provider with WebSphere Application Server.

What to do next

You can configure JMS resources to be provided by WebSphere MQ, by using the WebSphere administrative console to define WebSphere MQ resources.

After installing WebSphere MQ and WebSphere Application Server on the same host, you should only service WebSphere MQ with its CSD updates, and separately service WebSphere Application Server with its fix packs. This approach helps to avoid potential failures if you later decide to uninstall WebSphere Application Server fix packs. Also, if you apply a fix pack to WebSphere Application Server, specify not to update the Embedded Messaging feature.


Related tasks
Defining a generic JMS provider
Installing and configuring a JMS provider
Moving from the embedded WebSphere JMS provider to WebSphere MQ
Configuring resources for the WebSphere MQ JMS provider



Searchable topic ID:   tmj_instm
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/tmj_instm.html

Library | Support | Terms of Use | Feedback