Progress
External Program
Interfaces


requestReply

In Session Objects

Request/Reply is a mechanism for the JMSReplyTo message header field to specify the destination where a reply to a message should be sent. The requestReply method sends a message to a destination and designates the messageConsumer parameter for processing replies. Since this call is supported by both the pubsubsession.p object and the ptpsession.p object, Progress uses the term, destination, which can be used for both topics and queues.

The 4GL–JMS implementation automates the request/reply sequence:

The 4GL–JMS implementation uses a temporary destination for the reply. It is an error to set the JMSReplyTo field of the message explicitly if requestReply is used. The reply is received by messageConsumer asynchronously, just like any other message reception. The temporary destination is deleted when the Message Consumer object is deleted:

SYNTAX
PROCEDURE requestReply.  
DEFINE INPUT PARAMETER destination AS CHAR.  
DEFINE INPUT PARAMETER message AS HANDLE. 
DEFINE INPUT PARAMETER replySelector AS CHAR.      /*UNKNOWN means 
                                                     receiving all replies*/ 
DEFINE INPUT PARAMETER messageConsumer AS HANDLE.  /*UNKNOWN is illegal*/ 
DEFINE INPUT PARAMETER priority AS INT.            /*Session default is 
                                                     used if UNKNOWN./* 
DEFINE INPUT PARAMETER timeToLive AS DECIMAL.      /*Session default is 
                                                     used if UNKNOWN./* 
DEFINE INPUT PARAMETER deliveryMode AS CHAR.       /*Session default is 
                                                     used if UNKNOWN./* 

NOTE: This procedure executes remotely (sends a message to the SonicMQ Adapter).

For information on this procedure in context, see the "Request/Reply" section in Accessing SonicMQ Messaging From the Progress 4GL."


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095