DELETE EVENT
Delete a BTS event.
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:
- 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.
- 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.