Exception event types and their properties

Exception events are generated for data rules in InfoSphere® Information Analyzer and the Exceptions stage of InfoSphere DataStage® and QualityStage® jobs.

To see and create subscriptions to exception event types in the Subscription Manager you must have the role of Exception Management Administrator or Data Steward Manager.

The following table describes the names and descriptions of exception event types and the applications that are registered by default for each event type. You can also create your own applications, and then register them to event types by using the istool command event registerCallback.
Table 1. Exception event types
Name Description Applications that are registered by default
NEW_EXCEPTIONS_EVENT This event is generated when new exceptions are generated by an exception provider. Exception providers are InfoSphere Information Analyzer and the Exceptions stage in InfoSphere DataStage and QualityStage.

Data Quality Exception Console.

When a NEW_EXCEPTIONS_EVENT occurs, this application displays the exception set to the Data Quality Exception Console.

NEW_MANAGED_SET_EVENT This event is generated when exception sets are created and marked Managed with IBM Stewardship Center in the Data Quality Exception Console. The Data Quality Exception Console automatically creates a NEW_MANAGED_SET_EVENT when it receives notification of a NEW_EXCEPTIONS_EVENT.

IBM Stewardship Center - Data Quality Exception.

When a NEW_MANAGED_SET_EVENT occurs, this sample process application sends the exception set to the Stewardship Center.

The following table describes the properties that you can use to filter subscriptions to exception event types.
Table 2. Filter properties for exception event types
Event type property Description Valid values
applicationType The product or tool that generated the exception.
  • Information Analyzer
  • Exception Stage
    Note: Exception is singular in this case.
.
projectName The name of the project that the exception was generated in.
  • If you specify Information Analyzer for applicationType, specify the name of an InfoSphere Information Analyzer project.
  • If you specify Exception Stage for applicationType, specify the name of an InfoSphere DataStage and QualityStage project.
exceptionSummaryName or exceptionDescriptorName The name of the data rule, or the name of the exception descriptor in a stage that generated the exception.
  • exceptionSummaryName is used with NEW_EXCEPTIONS_EVENT.
  • exceptionDescriptorName is used with NEW_MANAGED_SET_EVENT.
  • If you specify Information Analyzer for applicationType, specify the name of a data rule in the specified project.
  • If you specify Exception Stage for applicationType, specify the name of an exception descriptor in an exception stage in the specified project.
    Note: Your subscription includes events of the selected type that occur in any stage in any job in the specified project where the stage contains an exception descriptor of the specified name. To limit the subscription to events from a single stage, define a unique name for the exception descriptor in that stage.
exceptionSummaryUID or exceptionDescriptorUID The unique identifier of the data rule, or the unique identifier of the exception descriptor.
  • exceptionSummaryUID is used with NEW_EXCEPTIONS_EVENT.
  • exceptionDescriptorUID is used with NEW_MANAGED_SET_EVENT.