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