WAS v8.5 > End-to-end paths > Web services - Transports

Configure a permanent replyTo queue for JAX-RPC web services using SOAP over JMS (deprecated)

When using two-way web service communications using the IBM proprietary SOAP over JMS transport, we can benefit from configuring a permanent replyTo queue on JAX-RPC web services client to prevent the client from having to create a temporary reply queue each time a web service request is made. Deprecated feature: Beginning with WebSphere Application Server 7.0, the IBM proprietary SOAP over JMS protocol is deprecated in favor of the emerging industry standard protocol. We can use the IBM proprietary SOAP over JMS protocol with your Java API for XML Web Services (JAX-WS) or JAX-RPC web services, however, you are encouraged to take advantage of the SOAP over JMS protocol standard. This task describes configuring a permanent replyTo queue when using the IBM proprietary SOAP over JMS transport. To learn more about the SOAP over JMS standard, see the using SOAP over JMS to transport web services documentation.

A permanent replyTo queue is configured on the web services client in one of the following ways:

• Specify the optional replyToDestination property in the JMS endpoint URL.

• Set the replyTo queue programmatically on the client JAX-RPC Stub or Call object. Setting the replyTo queue as a Stub or a Call property affects all requests that are invoked using that Stub or Call object.

• Set the replyTo queue as a JVM system property. Setting the replyTo queue as a JVM system property affects all of your SOAP over JMS clients running in the particular JVM. If there are multiple clients in the same application that need to use a different replyTO queue, then the best option is to set the property programmatically.

To set the permanent replyTo queue using any of these options, only client-side configuration is necessary. There is no configuration necessary on the web service provider side.

• Specify the optional replyToDestination property in the JMS endpoint URL.

  jms:/queue?destination=jms/MyRequestQueue&connectionFactory=
  jms/MyCF&replyToDestination=jms/MyReplyQueue&targetService=MyService

• Set the replyTo queue programmatically on the client JAX-RPC Stub or Call object.

  The client uses the JAX-RPC Stub or Call object to invoke the web service.

  ((javax.xml.rpc.Stub)stub)._setProperty(com.ibm.wsspi.webservices.Consta 
  nts.JMS_REPLY_QUEUE_JNDI_NAME, 
  "jms/Permanent_Q"); 

  The value of the property is a String.

• Set the replyTo queue as a JVM system property.

  • For a Java client invocation, enter at a command prompt:

    java -Dcom.ibm.websphere.webservices.JMSReplyQueueJndiName=jms/Permanent_Q

  • For a JVM running on the application server:

    • Set a JVM system property using the dmgr console for the application server which runs the web service client application.

      To set custom properties, connect to the dmgr console and navigate to the Java virtual machine custom properties panel.

      1. Click Servers > Server Types > WebSphere application servers > server_name > Java and Process Management > Process Definition > Java Virtual Machine > Custom Properties > New

      2. Set the Name property to: com.ibm.websphere.webservices.JMSReplyQueueJndiName

      3. Set the Value property to: jms/Permanent_Q

      4. Click OK to save your changes.

      5. Restart the application server.

Results

Your web services client can now receive IBM proprietary SOAP over JMS messages from a permanent replyTo queue.

Related

Use SOAP over JMS to transport web services
Tasks: Implementing web services applications
Java virtual machine custom properties

Related information:

IBM proprietary SOAP over JMS protocol (deprecated)
SOAP over JMS protocol
IBM proprietary JMS endpoint URL syntax (deprecated)

+

Search Tips   |   Advanced Search