Use a Verb Group

This Subroutine may be used to indicate which already existing Verb Group is to be made active. Thus all subsequently defined Verbs will belong to this group, and Command Line responses will be limited to only those Verbs belonging to this Group.

Short Name Calling Sequence

STATUS = UIUSGP(GROUP[,OLDGRP])

Long Name Calling Sequence

STATUS = UI_USE_GROUP(...)

Input Arguments

GROUP (Integer) Group ID

Output Arguments

GROUP (Integer) Old Group ID (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_GROUP ) Illegal Group ID UIILGP ) Note:

1. The specified Group must already have been defined by a prior call to UI_DEFINE_GROUP (or be Group 0, which is always defined).
2. The OLDGRP Argument is optional and, if present, will be set to the Group that was in use prior to this call.