Develop > Persistence layer > WebSphere Commerce Web services with JSP pages > Understand the WebSphere Commerce Web service framework

Enable JMS for Web services

 

+

Search Tips   |   Advanced Search

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...

1. defining the JMS resources
2. defining a Messaging Listener Port
3. deploying a Message Driven Bean

Web services over JMS support is provided as part of WebSphere Commerce Enhancements for version 6.

Procedure

1. Define JMS resources

   1. Start the server.

   2. Open and log in to the Administration Console:
      • http://hostname:9102/ibm/console/
      • localhost:9060/ibm/console/

   3. Go to...

      Resources | JMS Providers | WebSphere MQ

   4. Create a WebSphere MQ queue connection factory and a WebSphere MQ queue destination.

2. Define the Messaging Listener Port

   1. Open and log in to the Administration Console:
      • http://hostname:9102/ibm/console/
      • localhost:9060/ibm/console/

   2. Go to...

      Server | Application Server | WCS_server | Communication | Messaging | Message Listener Service | Listener Port

   3. 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 WebSphere MQ queue waiting to be associated with a message driven bean to process the message.

3. Deploy 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 Administration Console:
      • http:// hostname:9102/ibm/console/
      • localhost:9060/ibm/console/

   2. Go to...

      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 file...

      WebServicesJMSRouter.jar

      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.

   More information about Web services can be found in the WebSphere 6 Web services handbook ( http://www.redbooks.ibm.com/abstracts/sg246461.html).

Related concepts

WebSphere Commerce Web services with JSP pages
Understand the WebSphere Commerce Web service framework

Related tasks

Configure WebSphere Commerce Developer for Web service development

Related reference

WebServicesRouter Web module configuration

+

Search Tips   |   Advanced Search