REMOVE SUBEVENT

Remove a sub-event from a BTS composite event.

REMOVE SUBEVENT

Read syntax diagramSkip visual syntax diagramREMOVESUBEVENT( data-value)EVENT( data-value)

Conditions: EVENTERR, INVREQ

Description

REMOVE SUBEVENT removes a sub-event from a named BTS composite event.

This call does not delete the removed event. Nor does it reset the event's fire status. Note that, after this call, the removed event—because it is no longer a sub-event—will cause the current activity to be reattached if it fires.

Removing a sub-event causes the composite's predicate to be re-evaluated.

Options

EVENT(data-value)
specifies the name (1–16 characters) of the composite event.
SUBEVENT(data-value)
specifies the name (1–16 characters) of the event which is to be removed from the named composite event.

Conditions

111 EVENTERR
RESP2 values:
4
The event specified on the EVENT option is not recognized by BTS.
5
The sub-event specified on the SUBEVENT 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 is not a composite event.
3
The event specified on the SUBEVENT option is not a sub-event of the composite event specified on the EVENT option.