Enabling JMS for Web services

JMS support for Web services is not enabled when HCL Commerce is installed. This is because the JMS resources are required to be set up or the HCL Commerce Server will report errors during start up. Enabling Web service over JMS support involves defining the JMS resources, defining a Messaging Listener Port, and deploying a Message Driven Bean.

Before you begin

Ensure that your server is started.

Procedure

  1. Defining JMS resources
    1. Start the server.
    2. Open and log in to the WebSphere Administration Console:
      • http://hostname:9102/ibm/console/
      • localhost:9060/ibm/console/
    3. Go to the Resources > JMS > JMS Providers > IBM MQ menu.
    4. Create a IBM MQ queue connection factory and a IBM MQ queue destination.
    Create the JMS resources.
  2. Defining the Messaging Listener Port
    1. Open and log in to the WebSphere Administration Console:
      • http://hostname:9102/ibm/console/
      • localhost:9060/ibm/console/
    2. Go to the Server > Application Server menu.
    3. Select the server where the HCL Commerce application resides (i.e. server1).
    4. Expand the Communication > Messaging option and select Message Listener Service
      Select Message Listener Service
    5. Select the Listener Port option and create a new Listener port for listening for HCL Commerce Web service requests. Call the listener port WebSphereCommerceWebServices and use the JNDI names for the queue connection factory and destination queue created previously.

    Once this is defined, now there is a listening process that will listen to a particular IBM MQ queue waiting to be associated with a message driven bean to process the message.

  3. Deploying the JMS message driven bean

    In order to listen to the JMS queue for inbound Web service requests, a Message Driven Bean needs to be deployed and associated with a Messaging Listener port. Use the WebServicesJMSRouter.jar EJB module and perform the following steps to deploy the Message Driven Bean.

    1. Open and log in to the WebSphere Administration Console:
      • http://hostname:9102/ibm/console/
      • http://localhost:9060/ibm/console/
    2. Go to the Application > Enterprise Applications.
    3. Check the check box beside the HCL Commerce application and select the Update button.
      Select HCL Commerce application, Update
    4. In the update application menu, select single module and specify the WebServicesJMSRouter.jar file. In the relative path to module, input WebServicesJMSRouter and then select the next button.
      WebServicesJMSRouter, Next
    5. Select the Next button in the Preparing the application for installation screen.
    6. Select the Next button in the Security Warning screen.
    7. Follow the installation screens and ensure the proper Listener Port and JMS Queue Connection Factory are specified when deploying the EJB module.

    For more information about Web services, see IBM WebSphere Application Server V7.0 Web Services Guide.