tibemsAcknowledgeMode


Type

Purpose

Define acknowledgement mode constants.

(Sheet 1 of 2)

Constant
Description
TIBEMS_AUTO_ACKNOWLEDGE
In this mode, the session automatically acknowledges a message when message processing is finished—that is, when either of these calls returns successfully:
TIBEMS_CLIENT_ACKNOWLEDGE
In this mode, the client program acknowledges receipt by calling tibemsMsg_Acknowledge . Each call acknowledges all messages received so far.
TIBEMS_DUPS_OK_ACKNOWLEDGE
As with TIBEMS_AUTO_ACKNOWLEDGE, the session automatically acknowledges messages. However, it may do so lazily.
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. Lazy acknowledgement can reduce session overhead.
TIBEMS_EXPLICIT_CLIENT_ACKNOWLEDGE
As with TIBEMS_CLIENT_ACKNOWLEDGE, the client program acknowledges receipt by calling tibemsMsg_Acknowledge . However, each call acknowledges only the individual message. The client may acknowledge messages in any order.
This mode and behavior are proprietary extensions, specific to TIBCO EMS.
TIBEMS_EXPLICIT_CLIENT_DUPS_OK_ACKNOWLEDGE
In this mode, the client program lazily acknowledges only the individual message, by calling tibemsMsg_Acknowledge . The client may acknowledge messages in any order.
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.
TIBEMS_NO_ACKNOWLEDGE
In TIBEMS_NO_ACKNOWLEDGE mode, messages do not require acknowledgement (which reduces message overhead). The server never redelivers messages.
This mode is available for topic sessions only.
This mode and behavior are proprietary extensions, specific to TIBCO EMS.

COBOL

01  TIBEMS-ACKNOWLEDGE-MODES. 
     05  TIBEMS-AUTO-ACKNOWLEDGE        PIC S9(8) COMP VALUE   1. 
     05  TIBEMS-CLIENT-ACKNOWLEDGE      PIC S9(8) COMP VALUE   2. 
     05  TIBEMS-DUPS-OK-ACKNOWLEDGE     PIC S9(8) COMP VALUE   3. 
     05  TIBEMS-NO-ACKNOWLEDGE          PIC S9(8) COMP VALUE  22. 
     05  TIBEMS-EXPLICIT-CL-ACK         PIC S9(8) COMP VALUE  23. 
     05  TIBEMS-EXPLICIT-CL-DUPS-OK-ACK PIC S9(8) COMP VALUE  24. 

TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com