tibrvcmEvent_ConfirmMsg()

Function

Declaration

tibrv_status tibrvcmEvent_ConfirmMsg(
    tibrvcmEvent         cmListener,
    tibrvMsg             message);

Purpose

Explicitly confirm delivery of a certified message.

Remarks

Use this function only in programs that override automatic confirmation (see tibrvcmEvent_SetExplicitConfirm()). The default behavior of certified listeners is to automatically confirm delivery when the callback function returns.

Parameter	Description
cmListener	Confirm receipt by this listener.
message	Confirm receipt of this message.

Unregistered Message

When a CM listener receives a labeled message, its behavior depends on context:

•

If a CM listener is registered for certified delivery, it presents the supplementary information to the callback function. If the sequence number is present, then the receiving program can confirm delivery.

•

If a CM listener is not registered for certified delivery with the sender, it presents the sender’s name to the callback function, but omits the sequence number. In this case, the receiving program cannot confirm delivery; tibrvcmEvent_ConfirmMsg() returns the status code TIBRV_NOT_PERMITTED.

Notice that the first labeled message that a program receives on a subject might not be certified; that is, the sender has not registered a certified delivery agreement with the listener. If appropriate, the certified delivery library automatically requests that the sender register the listener for certified delivery. (See Discovery and Registration for Certified Delivery in TIBCO Rendezvous Concepts.)

A labeled but uncertified message can also result when the sender explicitly disallows or removes the listener.

See Also

tibrvcmEvent

tibrvcmEvent_SetExplicitConfirm()