event unregisterCallback command

The suite administrator can use the istool event unregisterCallback command to unregister an application so that it can no longer receive and process notifications of events of a specific type.

Purpose

When you use the Subscription Manager to create a subscription for an event type, you can specify the name of an application that is registered with the Common Event Framework. Some event providers register applications by default. To unregister an application that you no longer need to be available for subscriptions to an event, you use the event unregisterCallback command. You can use the command event listCallbacks to view a list of all applications or of all applications for a specific event type.

Requirements

You must have the IBM® InfoSphere® Information Server suite administrator role.

Run the command from a computer that is on the engine tier or the client tier.

Before you can unregister an application, you must delete any subscriptions that use the application. To find which subscriptions use the application, on the Subscriptions tab of the Subscription Manager, click each subscription to view its application. Click Delete to delete a selected subscription.

Note: To receive a continuous flow of notifications for an event type, before you delete a subscription, create another subscription for the event type.

Command syntax

The preferred way to run this command is in the istool command-line window. If you run this command in your operating system command-line window or in scripts, you must add istool before the command name.

event unregisterCallback
authentication parameters
[generic parameters]
-eventTypeName event_type
-callbackName application_name

Parameters

These parameters are specific to the event unregisterCallback command. For authentication parameters and generic parameters, see Commands and common parameters for istool.

-eventTypeName | -etn event_type: Required. Specifies the name of the event type that the application is registered for.
-callbackName | -cbn application_name: Required. The name of the application. Surround the name in double quotation marks (") if it contains spaces.

Example

The following command unregisters an application that links the event type IGC_BUSINESSRULE_EVENT with the IBM BPM Rule Approval process.

event unregisterCallback -eventTypeName IGC_BUSINESSRULE_EVENT 
-callbackName BPM_RULE_APPROVAL_PROCESS  
-domain localhost -u isAdminUser -p isAdminPwd

The following command unregisters an application that sends notifications of events of the type NEW_EXCEPTIONS_EVENT to the application APPLICATION1.

event unregisterCallback -eventTypeName NEW_EXCEPTIONS_EVENT 
-callbackName "APPLICATION1"  
-u isAdminUser -p isAdminPwd