Event definitions no longer needed can be removed from the event
catalog.
Why and when to perform this task
If an event definition is no longer needed, you can remove it from
the event catalog.
Note: If WebSphere security is enabled, the application
user ID must be mapped to the catalogAdministrator role to remove event definitions
from the event catalog.
Steps for this task
To remove an event definition from the event catalog, use the removeEventDefinition
method. eventCatalog.removeEventDefinition(name)
The
name parameter
is the name of the event definition you want to remove from the event catalog.
If no matching event definition exists in the event catalog, an EventDefinitionNotFoundException
exception is thrown.
Result
When an event definition is removed from the event catalog, its
children and all other descendants are also removed. For each event definition
that is removed, the event catalog sends an event to the event server notifying
event consumers that this change has taken place. See Change notification for
more information.
Note: When an event definition is removed, the event
catalog does not check the event server to determine whether any existing
events in the event data store are described by that event definition. Therefore,
you should make certain that an event definition is no longer needed before
removing it from the event catalog.