Products | Versions |
---|---|
TIBCO Adapter SDK | - |
Not Applicable | - |
Resolution:
To unregister, or remove, a certified listener from a certified publisher adapter at run-time, you can use SDK Class microagent COM.TIBCO.ADAPTER.<instanceId>::unRegisterListener() method. The use of a microagent method requires that you use the hawk display or equivalent application to invoke the method.
This method requires two parameters:
1) the publisher name, from which the certified message is published
2) the cmName of the certified listener
If you do not know the publisher's name, you can use the other SDK class microagent method COM.TIBCO.ADAPTER.<instanceId>::getComponents() method to find the ComponentName of the publisher.
If you do not know the cmName of the certified listener, you can use yet another SDK class microagent method COM.TIBCO.ADAPTER.<instanceId>::reviewLedger()
Before invoking unRegisterListener() method, shutdown the cm subscriber. A common user mistake is to leave the subscriber running while invoking the unRegisterListener() method. Doing so will cause the method to seem as if it has no effect since the running certified subscriber will re-register itself.
unRegisterListener() calls tibrvcmTransport_RemoveListener() which is different from tibrvcmTransport_DisallowListener().
After the unregistration, the subscriber session and all the undelivered messages will be removed from the ledger.