Delete a BTS event.

DELETE EVENT
>>-DELETE--EVENT(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:
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
- EVENTERR
- RESP2 values:
- 4
- The event specified on the EVENT option is not recognized by BTS.
- 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.