Function
Acknowledge messages.
tibems_status
tibemsMsg_Acknowledge(tibemsMsg
message );
Parameter
|
Description
|
---|---|
message
|
Acknowledge this message (but for the actual behavior of this call, see the Remarks below).
|
The behavior of this call depends on the acknowledgement mode of the tibemsSession
.
TIBEMS_CLIENT_ACKNOWLEDGE
mode, this call acknowledges all messages that the program has consumed within the session. (This behavior complies with the JMS specification.)TIBEMS_EXPLICIT_CLIENT_ACKNOWLEDGE
mode, this call acknowledges only the individual message. (This mode and behavior are proprietary extensions, specific to TIBCO EMS.)TIBEMS_EXPLICIT_CLIENT_DUPS_OK_ACKNOWLEDGE
mode, this call lazily acknowledges only the individual message. Lazy means that the provider client library can delay transferring the acknowledgement to the server until a convenient time; meanwhile the server might redeliver the message. (This mode and behavior are proprietary extensions, specific to TIBCO EMS.)Two events mark a message as consumedthat is, eligible for acknowledgment using this function:
tibemsMsgCallback
function, it marks the message argument as consumed.The server might redeliver unacknowledged messages.
It is illegal to call this function after closing the session, the connection or the consumer through which the message arrived.
TIBCO Enterprise Message Service™ C and COBOL Reference System Release 4.3, February 2006 Copyright © TIBCO Software Inc. All rights reserved www.tibco.com |