How can I "decertify" (unregister) a certified listener on an Adapter SDK based publisher? I would like to do so without shutting down the SDK publisher and deleting the ledger file.

How can I "decertify" (unregister) a certified listener on an Adapter SDK based publisher? I would like to do so without shutting down the SDK publisher and deleting the ledger file.

book

Article ID: KB0084512

calendar_today

Updated On:

Products Versions
TIBCO Adapter SDK -
Not Applicable -

Description

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.&ltinstanceId>::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.&ltinstanceId>::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.&ltinstanceId>::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.

Issue/Introduction

How can I "decertify" (unregister) a certified listener on an Adapter SDK based publisher? I would like to do so without shutting down the SDK publisher and deleting the ledger file.

Environment

Product: TIBCO Adapter SDK Version: All OS: All --------------------