tibrvcmTransport_DisallowListener()

Function

Declaration

tibrv_status tibrvcmTransport_DisallowListener(
    tibrvcmTransport    cmTransport,
    const char*         cmName);

Purpose

Cancel certified delivery to all listeners at a specific correspondent. Deny subsequent certified delivery registration requests from those listeners.

Remarks

Disallowed listeners still receive subsequent messages from this sender, but delivery is not certified. In other words:

•

The first labeled message causes the listener to initiate registration. Registration fails, and the listener discards that labeled message.

•

The listener receives a REGISTRATION.NOT_CERTIFIED advisory, informing it that the sender has canceled certified delivery of all subjects.

•

If the sender’s ledger contains messages sent to the disallowed listener (for which this listener has not confirmed delivery), then Rendezvous software removes those ledger items, and does not attempt to redeliver those messages.

•

Rendezvous software presents subsequent messages (from the canceling sender) to the listener without a sequence number, to indicate that delivery is not certified.

Senders can promptly revoke the acceptance of certified delivery by calling tibrvcmTransport_DisallowListener() within the callback function that processes the REGISTRATION.REQUEST advisory.

This function disallows a correspondent by name. If the correspondent terminates, and another process instance (with the same reusable name) takes its place, the new process is still disallowed by this sender.

To supersede the effect of tibrvcmTransport_DisallowListener(), call tibrvcmTransport_AllowListener().

Parameter	Description
cmTransport	Instruct this transport to disallow the named listeners.
cmName	Cancel certified delivery to listeners of the transport with this name.

See Also

Name

tibrvcmTransport_AllowListener()

Disallowing Certified Delivery in TIBCO Rendezvous Concepts