Open topic with navigation

TIBCO Rendezvous® 8.8.0

# TibrvCmTransport.removeListener()

Method

## Declaration

    void removeListener(
        java.lang.String    cmName,
        java.lang.String    subject)
      throws TibrvException

## Purpose

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

## Remarks

This method 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 method 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 method, 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 method 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 TibrvCmTransport, then TibrvCmTransport.removeListener() throws an exception with the status code TibrvStatus.INVALID_ARG.

Parameter | Description
`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-2025. Cloud Software Group, Inc. All Rights Reserved.