Canceling Certified Delivery

Either a listening or a sending program can cancel a certified delivery agreement.

A listening program can cancel agreements when destroying the CM listener event object, using a cancel agreements parameter of the calls in Close Listener Calls. All sending CM transports that had certified delivery agreements to the destroyed listener present REGISTRATION.CLOSED advisories.

Notice that destroying the CM transport object in the listening program implicitly invalidates all its listener events, but does not cancel their certified delivery agreements; the sender continues to store outbound messages in its ledger.

Close Listener Calls

C	tibrvcmEvent_Destroy()
C++	TibrvCmListener::destroy()
Java	TibrvCmListener.destroy()
.NET	CMListener.Destroy

A certified sender transport can cancel certified delivery of a specific subject to a specific CM listening transport, using calls in Remove Listener Calls. The sender transport deletes from its ledger all information about delivery of the subject to the listening transport. The sender presents a REGISTRATION.CLOSED advisory. If the listening correspondent is available (that is, its program is running and reachable), it presents a REGISTRATION.NOT_CERTIFIED advisory. (Unlike the disallow listener calls in Disallow Listener Calls, these calls do not cause denial of subsequent registration requests.)

Remove Listener Calls

C	tibrvcmTransport_RemoveListener()
C++	TibrvCmTransport::removeListener()
Java	TibrvCmTransport.removeListener()
.NET	CMTransport.RemoveListener