About Event Handler Status

Each event handler can exit with a Success or Failure status. When an event handler fails, if it is not set to ignore failures, and if it has not attempted an illegal operation, the system can retry the event handler’s actions.

Success

An event handler exits with a Success status only when it reaches a Finish event action or completes all event actions successfully without reaching a Fail event action.

Failure

An event handler exits with a Failure status when it does any of these:

  • Reaches a Fail event action
  • Attempts an illegal operation
  • Experiences an unexpected failure of an event action or something launched by an event action

When a failure occurs:

  • In the Result field of the Event Handler Status form, an appropriate error message is displayed, which includes an error message passed from a failing stored procedure in @Infobar message type parameter, where applicable.
  • On the Actions tab of the Event Handler Status form, the Times Failed counter for the current event action state is incremented.
  • On the Handlers tab of the Event Handler Status form, the event handler state's Last Activity Date is set to the date and time of the failure.
  • On the Variables tab of the Event Handler Status form, any event variables are maintained at their current values for inspection.