next up previous contents
Next: Define Verb Priority Up: Verb Parameter and Previous: Define Alias Name

Drop Delete Alias Name s for Verb

This Subroutine drops (deletes) Alias Names associated with the currently setup Verb within the currently setup Verb Group. All Aliases beginning with the specified Name will be dropped.

Short Name Calling Sequence

STATUS = UIDRAL(ALIAS)

Long Name Calling Sequence

STATUS = UI_DROP_ALIAS(....)

Input Arguments

ALIAS (Character) Alias Name Text

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VERB ) Illegal Verb UIILVB )

UI__LOCKED_GROUP ) Group Locked UIGLOK ) Note:

  1. The specified Alias Name must refer to an already defined Alias (or truncation thereof) for the currently setup Verb within the currently setup Verb Group.
  2. All Aliases that satisfy the Name match will be dropped. Thus, if 'A' is specified as the Alias Name, all Aliases beginning with the letter A will be dropped.
  3. If the ALIAS Argument is '*' it is treated as a wildcard and all Aliases associated with the currently setup Verb 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.


Liz Buckle
Fri Jan 13 17:24:10 CST 1995