Open topic with navigation

TIBCO Rendezvous® 8.7.0

# tibrvcmTransport_RemoveListener()

Function

## Declaration

    tibrv_status tibrvcmTransport_RemoveListener(
        tibrvcmTransport    cmTransport,
        const char*         cmName,
        const char*         subject);

## Purpose

Unregister a specific listener at a specific correspondent, and free associated storage in the sender’s ledger.

## Remarks

This function cancels certified delivery of the specific `subject` to the correspondent with this `name`. The listening correspondent may subsequently re-register for certified delivery of the subject. (In contrast, tibrvcmTransport_DisallowListener() cancels certified delivery of all subjects to the correspondent, and prohibits re-registration.)

Senders can call this function when the ledger item for a listening correspondent has grown very large. Such growth indicates that the listener is not confirming delivery, and may have terminated. Removing the listener reduces the ledger size by deleting messages stored for the listener.

When a sending program calls this function, certified delivery software in the sender behaves as if the listener had closed the endpoint for the `subject`. The sending program deletes from its ledger all information about delivery of the `subject` to the correspondent with this `cmName`. The sending program receives a `REGISTRATION.CLOSED` advisory, to trigger any operations in the callback function for the advisory.

If the listening correspondent is available (running and reachable), it receives a `REGISTRATION.NOT_CERTIFIED` advisory, informing it that the sender no longer certifies delivery of the subject.

If the correspondent with this `name` does not receive certified delivery of the `subject` from this sender `cmTransport`, then tibrvcmTransport_RemoveListener() returns the status code TIBRV_INVALID_SUBJECT.

Parameter | Description
`cmTransport` | Instruct this transport to unregister the specified listeners.
`cmName` | Cancel certified delivery of the subject to listeners of this correspondent.
`subject` | Cancel certified delivery of this subject to the named listener. Wildcard subjects are illegal.

## See Also

Name

tibrvcmTransport_AddListener()

tibrvcmTransport_DisallowListener()

Canceling Certified Delivery in TIBCO Rendezvous Concepts

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.