Progress
External Program
Interfaces


acknowledgeAndForward

In Message Consumer Objects

This procedure applies inside a message event handler. The session must be set to SINGLE_MESSAGE_ACKNOWLEDGE.

The procedure expects a destination queue name, the original message handle, and optional message-delivery properties. If the message-delivery properties are set to ? (the unknown value), the procedure uses the original values from the message.

If the procedure is successful, the message is forwarded and acknowledged in a single, atomic operation. If the procedure is not successful — for example, if the destination does not exist — the message is not acknowledged and eventually returns to the queue:

SYNTAX
PROCEDURE acknowledgeAndForward. 
DEFINE INPUT PARAMETER destinationName AS CHARACTER. 
DEFINE INPUT PARAMETER messageH        AS HANDLE. 
DEFINE INPUT PARAMETER priority        AS INTEGER. 
DEFINE INPUT PARAMETER timeToLive      AS DECIMAL. 
DEFINE INPUT PARAMETER persistency     AS CHARACTER. 

For information on this procedure, see the "Acknowledge and Forward" 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