Configuring a permanent reply queue for web services using SOAP over JMS

When using two-way web service communications using the industry standard SOAP over JMS protocol, you can benefit from configuring a permanent reply queue on a Java API for XML Web Services (JAX-WS) or Java API for XML-based RPC (JAX-RPC) web services client. The use of a permanent reply queue can improve performance because this reply queue prevents the client from having to create a temporary reply queue each time a web services request is invoked.

About this task

A permanent reply queue is configured on the web services client in one of the following ways:
  • Specify the optional replyToName property in the JMS endpoint URL.
  • Set the reply queue programmatically.
    • For a JAX-WS web services client, set the JNDI name of the reply queue programmatically on the client RequestContext object. Setting the reply queue JNDI name on the RequestContext object affects all subsequent requests that are invoked using that RequestContext object.
    • For a JAX-RPC web services client, set the JNDI name of the reply queue programmatically on the client Stub or Call object. Setting the reply queue JNDI name as a Stub or a Call property affects all subsequent requests that are invoked using that Stub or Call object.
  • Set the reply queue as a Java virtual machine (JVM) system property. Setting the reply queue as a JVM system property affects all of your web services clients running in the particular JVM. If there are multiple clients running in the same JVM that need to use a different reply queue, then this option does not work. Instead, use one of the other two options.

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

Use the typical administrative functions of the JMS messaging provider to create the permanent reply queue prior to configuring the reply queue with the web services client.

Procedure

Configure the JNDI name of the permanent reply queue using one of the following ways:

Results

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

Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 10:32 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=twbs_jmspermreplystd
File name: twbs_jmspermreplystd.html