TibrvCmTransport.disallowListener()
Method
Declaration
voiddisallowListener(
java.lang.String cmName)
throws TibrvException
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 method that processes the REGISTRATION.REQUEST advisory.
This method 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 |
|
|
Cancel certified delivery to listeners of the transport with this name. |