DELETE EVENT

Delete a BTS event.

DELETE EVENT

Read syntax diagramSkip visual syntax diagramDELETEEVENT( data-value)

Conditions: EVENTERR, INVREQ

Description

DELETE EVENT deletes a BTS event that is no longer needed. The event is removed from the current activity's event pool. An event can be deleted whether it has fired or not.

DELETE EVENT can be used to delete only the following types of event:
  • Input
  • Composite.
DELETE EVENT cannot be used to delete:
  • Activity completion events. These are implicitly deleted when a response from the completed activity is acknowledged by a CHECK ACTIVITY command issued by the activity's parent; or when a DELETE ACTIVITY command is issued.
  • Timer events. These are implicitly deleted when the expiry of the associated timer is acknowledged by a CHECK TIMER command; or when a DELETE TIMER command is issued.
  • System events.
Note:
  1. If the event to be deleted is included in the predicate of a composite event, it is removed from the predicate's Boolean expression. The fire status of the composite event (FIRED or NOTFIRED) is re-evaluated.
  2. Deleting a composite event has no effect on its sub-events.

Options

EVENT(data-value)
specifies the name (1–16 characters) of the event to be deleted.

Conditions

111 EVENTERR
RESP2 values:
4
The event specified on the EVENT option is not recognized by BTS.
16 INVREQ
RESP2 values:
1
The command was issued outside the scope of an activity.
2
The event specified on the EVENT option cannot be deleted because it is a system, timer, or activity completion event.