Open topic with navigation

TIBCO Rendezvous® 8.7.0

# 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()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.