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
- 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.