Drop a Qualifier from Verb

This Subprogram may be used to drop a previously defined Qualifier from the currently setup Verb in the currently setup Verb Group. This request will be treated as illegal if the currently setup Group is Locked.

Short Name Calling Sequence

STATUS = UIDRQU(QUAL)

Long Name Calling Sequence

STATUS = UI_DROP_QUALIFIER(...)

Input Arguments

QUAL (Character) Qualifier 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 )

UI__ILLEGAL_QUALIFIER ) Illegal Qualifier UIILQU ) Note:

1. The specified Qualifier must refer to an already defined Qualifier (or truncation thereof) for the currently setup Verb. Furthermore, it must be associated with the currently setup Verb Parameter if it is associated with one (determined by whether UI_DEFINE_PARAMETER or UI_USEPARAMETER was called prior to calling UI_DEFINE_QUALIFIER).
2. All Qualifiers satisfying the specified name will be dropped. Thus a call to UI_DROP_QUALIFIER with argument 'a' will cause all Qualifiers (associated with the currently setup Parameter if appropriate) beginning with the letter A to be dropped.
3. If the QUAL Argument is '*' it is treated as a wildcard and all Qualifiers associated with the currently setup Verb (and Parameter if appropriate) will be dropped.
4. Error UI__LOCKED_GROUP will be returned if the currently setup Verb Group has been locked by a prior call to UI_LOCK_GROUP.