Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Service Development | Working with Web Services | Working with Binders | Configuring Use of the Client Side Queue
 
Configuring Use of the Client Side Queue
You can enable use of the client side queue for a JMS binder in a consumer web service descriptor. The client side queue is a message store that contains JMS messages sent during service execution when the JMS provider was not available. Each JMS connection alias has its own client side queue. When the JMS provider becomes available, Integration Server sends messages from the client side queue to the JMS provider.
When use of the client side queue is enabled for a JMS binder and the JMS provider is not available at the time a web service connector sends a message using the JMS binding, Integration Server writes the message to the client side queue.
When use of the client side queue is disabled for a JMS binder and the JMS provider is not available at the time the web service connector executes, Integration Server throws an ISRuntimeException. Integration Server includes the exception in the fault document returned to the web service connector.
Keep the following points in mind when enabling use of the client side queue for a JMS binder:
*The client side queue associated with the JMS binder is determined by the JMS connection alias in the consumer web service endpoint alias for the binder. The maximum size of the client side queue must be greater than zero. If the JMS connection alias sets the size of the client side queue to zero (Maximum Queue Size is set to 0), the client side queue is effectively disabled. Integration Server will not write messages to a client side queue that has a maximum size of 0 messages. For more information about configuring a JMS connection alias, see webMethods Integration Server Administrator’s Guide
*The client side queue can be used with web service connectors for In-Only and In-Out operations. For an In-Out operation, the reply to destination for the web service must be a non-temporary queue.
*To configure the use of the client side queue for a JMS binder
1. In the Package Navigator view in theService Development perspective, open and lock the web service descriptor containing the binder for which you want to configure the use of the client side queue.
2. In the Binders tab, select the JMS binder for which you want to configure the use of the client side queue.
3. In the Properties view, next to the Use CSQ property, select True to enable use of the client side queue. If you do not want Integration Server to use the client side queue for JMS messages sent using the binding represented by this binder, select False.
4. Click File > Save.