Synchronous

A synchronous event handler is one that must complete before the system continues to the next event handler in a sequence. For the entire event to be handled successfully, all synchronous handlers in the sequence must complete successfully. If one event handler fails, other than for an illegal operation, and the system is set to ignore failures for that handler, the system can continue to the next synchronous event handler. Otherwise, the system returns a failure error, and no more event handlers in the sequence execute.

By contrast, an asynchronous event handler runs independently of other event handlers.

On the Event Handlers form, select this check box to define the event handler as synchronous. Clear this check box to define the event handler as asynchronous. If this event handler includes any adjourning event action, this check box is disabled.

When the associated event is not a suspendable framework IDO event, this check box is also cleared. When the associated event is a suspendable framework IDO event, this check box matches the status of the Suspend check box.

On the Event Handler Sequence and Event Handler Revisions forms, this field is display-only, indicating whether the event handler is defined as a synchronous or asynchronous event handler.

On the Event Action Generate Event form, select this check box to instruct the system to treat the generated event as a synchronous event. Clear this check box to allow the generated event to run asynchronously.

Note:  You can reach this form only from the Event Actions form.

When you click OK to return to the Event Actions form, the system "wraps" this content within a SYNCHRONOUS( ) parameter, which yields this final syntax:

  • If selected: SYNCHRONOUS(TRUE)
  • If cleared: SYNCHRONOUS(FALSE)