Drop a Verb from Verb Group

This Subprogram may be used to drop a previously defined Verb from the currently setup Verb Group. Any Qualifiers associated with the Verb will also be dropped. This request will be treated as illegal if the currently setup Group is Locked.

Short Name Calling Sequence

STATUS = UIDRVB(VERB)

Long Name Calling Sequence

STATUS = UI_DROP_VERB(...)

Input Arguments

VERB (Character) Verb Text

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_GROUP ) Illegal Group ID UIILGP )

UI__LOCKED_GROUP ) Group Locked UIGLOK )

UI__ILLEGAL_VERB ) Illegal Verb UIILVB ) Note:

1. The specified Verb must refer to an already defined Verb (or truncation thereof) within the currently setup Verb Group.
2. All Verbs within the currently setup Verb Group that satisfy the Name match will be dropped. Thus, if 'A' is specified as the Verb Name, all Verbs beginning with the letter A will be dropped.
3. If the VERB Argument is '*' it is treated as a wildcard and all Verbs associated with the currently setup Verb Group will be dropped.
4. All Parameters and Qualifiers associated with the dropped Verbs will also be dropped.
5. Error UI__LOCKED_GROUP will be returned if the currently setup Verb Group has been locked by a prior call to UI_LOCK_GROUP.