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
event action or completes all event actions successfully without reaching a event action.Failure
An event handler exits with a Failure status when it performs any of these actions:
- Reaches a 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.