GROUP

This Command defines a Group ID for the subsequent definition of Verbs, Menus and Qualifiers. This Command must be present in order to allow Verbs etc. to be defined.

Parameters

GROUP_ID

Group ID. This must be an Integer in the range 0-4095 (denoting absolute addressing). or the following syntax may be used:-

GROUP #+n

\

where ``n" is an integer in the range 0-4095 (``GROUP #" is equivalent to ``GROUP #+0"). This implies self-relative addressing and the Group will be assigned an ID relative to the lowest Group ID defined within the file. If absolute addressing is used at all within the File, this is the lowest Group ID. If self-relative addressing is used throughout the File, then this Base ID is the first unassigned ID at the time the file is read and all Groups will be assigned IDs relative to this. In this latter case the calling program should use the optional arguments to the UI_DEFINE_FILE subprogram to determine which Groups were actually defined.

Qualifiers

/VIEWPORT=<id>

Specifies the Viewport within which Menus within this Group will be displayed in Viewport Mode. This defaults to the MENU Viewport if this Qualifier is absent or has no associated Value. The syntax of the Viewport ID is described in full for the VIEWPORT Command.

There is no restriction on the same Group ID being specified more than once, so that, for example, all Verbs for all Groups could be specified first, followed by all Menus for all Groups. Groups are created as being unlocked and therefore modifications may be freely made within the Group. Qualifiers may be attached either to the Keyword or to the Group ID and thus the following is legal:-

GROUP  +4/VIEWPORT= +2