Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Messages : tibemsMsg : tibemsMsg_Acknowledge

tibemsMsg_Acknowledge
Function
Purpose
Acknowledge messages.
C Declaration
tibems_status tibemsMsg_Acknowledge(
    tibemsMsg message );
COBOL Call
CALL "tibemsMsg_Acknowledge"
USING BY VALUE message,
RETURNING tibems-status
END-CALL.
 
message has usage pointer.
Parameters
 
Remarks
The behavior of this call depends on the acknowledgement mode of the tibemsSession.
In TIBEMS_CLIENT_ACKNOWLEDGE mode, this call acknowledges all messages that the program has consumed within the session. (This behavior complies with the JMS specification.)
In TIBEMS_EXPLICIT_CLIENT_ACKNOWLEDGE mode, this call acknowledges only the individual message. (This mode and behavior are proprietary extensions, specific to TIBCO EMS.)
In 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.)
Consumed
Two events mark a message as consumed—that is, eligible for acknowledgment using this function:
Just before the provider calls an tibemsMsgCallback function, it marks the message argument as consumed.
Redelivery
The server might redeliver unacknowledged messages.
Restriction
It is illegal to call this function after closing the session, the connection or the consumer through which the message arrived.
See Also
tibemsMsgConsumer_Receive on page 170
tibemsSession on page 294
tibemsAcknowledgeMode on page 324

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved