About application event handler status

Each event handler can exit with a status of either Success or Failure. 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 performs any of these actions:

  • 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, these results occur:

  • In the Result field of the Event Handler Status form, an appropriate error message displays, 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.