Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsMsg_Recover
> Function
> Purpose
> Recover a single message.
> C Declaration
> tibems_status tibemsMsg_Recover(
> tibemsMsg message );
> COBOL Call
> CALL "tibemsMsg_Recover"
> USING BY VALUE message,
> RETURNING tibems-status
> END-CALL.

> | message has usage pointer.

> Parameters

> Parameter | Description
> message | Recover the specified message.

> Remarks
> When the application calls this function, TIBCO Enterprise Message Service puts this message back on the queue or topic and makes it available for redelivery. The JMSRedelivered header is set to true.
> This call is only legal for the TIBEMS_EXPLICIT_CLIENT_ACKNOWLEDGE and TIBEMS_EXPLICIT_CLIENT_DUPS_OK_ACKNOWLEDGE acknowledgement modes. In all other modes, this call returns TIBEMS_ILLEGAL_STATE.
> This function recovers only the specified message. To recover all unacknowledged messages from a session, use tibemsSession_Recover.
> Restriction
> It is illegal to call this function on an acknowledged message or on a message that is included in a transaction.
> Additionally, it is illegal to call this function twice on the same message, or again on a message that was previously recovered using tibemsSession_Recover.
> See Also
> tibemsSession_Recover on page 309
> tibemsAcknowledgeMode on page 312

Copyright © TIBCO Software Inc. All Rights Reserved