Decode String into Verb

This Subprogram will attempt to decode the specified text string into a Verb within the currently setup Verb Group (via a prior call to UI_USE_GROUP etc.). The text string may either correspond to a valid Verb or to an Alias thereof.

Short Name Calling Sequence

STATUS = UIDCVB(STRING,VERB)

Long Name Calling Sequence

STATUS = UI_DECODE_VERB(...)

Input Arguments

STRING (Character) Text String

Output Arguments

VERB (Character) Decoded Verb Text

Function Value

UI__SUCCESS ) Success UISUCC )

UI__ILLEGAL_VERB ) Illegal Verb UIILVB ) Note:

1. The VERB Argument will be set to the full text of the Verb if STRING corresponds to a valid Verb (or Alias thereof) within the currently setup Verb Group.
2. Case (upper or Lower) is ignored in making the match.
3. All Errors are informational only, no Error Message will be issued.
4. Any leading or trailing spaces or tabs within STRING will be ignored.