tibemsAcknowledgeMode

Type

Purpose

Define acknowledgment mode constants.

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 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.