Forwards and acknowledges a message in a single operation.

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.

Applies to

Message Consumer objects

Notes

• The message cannot be changed when using the acknowledgeAndForward procedure.
• 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 not successful—for example, if the destination does not exist—the message is not acknowledged and eventually returns to the queue.

See also

acknowledgeAndForward procedure, setSingleMessageAcknowledgement procedure, getSingleMessageAcknowledgement function, setNoAcknowledge procedure , getNoAcknowledge function

For more information, see the Message acknowledgement, forwarding, and recovery and the Single-message acknowledgement.