TIBCO Adapter SDK C++ Reference
MPublisher::unRegisterListener
MPublisher
Unregister a specific certified listener (durable subscriber in JMS scenario) and frees associated storage in the sending session’s ledger (JMS server in JMS scenario).
Remarks
For RV, this method cancels certified delivery of this sender’s subject to the correspondent named rsCertifiedSessionName.

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 (JMS server in JMS scenario) all information about delivery of messages on the subject to the correspondent specified by rsCertifiedSessionName. The sending program receives a REGISTRATION.CLOSED advisory to trigger any callback methods for that 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 rsCertifiedSessionName does not receive certified delivery of the subject from this session, this method returns the exception M_ERROR_RV_ERROR and the TIBCO Rendezvous error message .

 

For JMS, if the call fails, it results in M_ERROR_JMS. Advisories are NOT generated.

Parameters
Parameters Description
const MString& rsCertifiedSessionName Cancel certified delivery of the sender’s subject to the correspondent with this name (cancel durable subscriber with this durable name).
Exceptions
M_ERROR_RV_ERROR for RV

M_ERROR_JMS for JMS

Declaration
void unRegisterListener(const MString& rsCertifiedSessionName) throw(MException);
Links
Copyright (c) 2010 TIBCO Software Inc. All rights reserved.