Enable JMS for Web services

JMS support for Web services is not enabled when WebSphere Commerce is installed. This is because the JMS resources are required to be set up or the WebSphere 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 beginning

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 WebSphere Commerce application resides (i.e. server1).

   4. Expand the Communication > Messaging option and select Message Listener Service

      

   5. Select the Listener Port option and create a new Listener port for listening for WebSphere 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 WebSphere Commerce application and select the Update button.

      

   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.

      

   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.

Related concepts
WebSphere Commerce Web services with JSP pages
Understanding the WebSphere Commerce Web service framework

Related tasks
Configure WebSphere Commerce Developer for Web service development

Related reference
WebServicesRouter Web module configuration