MNUBAR (Menu Bar) keyword for display files

Use this record-level keyword to define a menu bar.

A menu bar is a horizontal list of choices that is followed by an optional separator line. The choices represent groups of related actions that the application user can select. For example, a group of actions appears in a pull-down menu when the user selects a menu-bar choice. A menu-bar record contains a field with one or more MNUBARCHC keywords that define the menu-bar choices. The separator line is generated by the system.

The format of the keyword is:

MNUBAR([*SEPARATOR | *NOSEPARATOR])

The parameter is optional and specifies whether a separator line should be placed below the last line of the menu-bar choices. *SEPARATOR indicates that a menu-bar separator line should be placed after the last line of the menu-bar choices. *NOSEPARATOR indicates that a menu-bar separator line should not be displayed. The default is *SEPARATOR.

Note: If *NOSEPARATOR is specified, the MNUBARSEP keyword cannot be specified on this record.

A record with the MNUBAR keyword specified must contain one and only one menu bar field (a field with one or more MNUBARCHC keywords), and cannot contain any displayable fields other than the menu bar field.

The following keywords are allowed on a record containing the MNUBAR keyword:

CAnn
CFnn
CLEAR
CLRL
CSRLOC
DSPMOD
HELP
HLPCLR
HLPCMDKEY
HLPRTN

HLPTITLE
HOME
INDTXT
INVITE
KEEP
LOCK
MNUBARDSP
MNUBARSEP
MNUBARSW

MNUCNL
OVERLAY
PAGEDOWN/PAGEUP
PRINT
PROTECT
ROLLUP/ROLLDOWN
TEXT
UNLOCK
VLDCMDKEY

Note: These keywords are ignored on the menu-bar record if the menu-bar record is displayed by the system (for example, if MNUBARDSP is specified on a record other than this menu-bar record).

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the MNUBAR keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A          R RECORD1                   MNUBAR
     A            MNUFLD         2Y 0I  1  2
     A                                      MNUBARCHC(1 RCDFILE 'File')
     A                                      MNUBARCHC(2 RCDEDIT 'Edit')
     A                                      MNUBARCHC(3 RCDVIEW 'View')
     A                                      MNUBARCHC(4 RCDOPT 'Options')
     A                                      MNUBARCHC(5 RCDHELP 'Help')
     A                                      :
     A                                      :
     A

In this example, RECORD1 is defined as a menu-bar record. When RECORD1 is displayed, the menu-bar choices defined on the field MNUFLD are displayed as a menu bar. The menu-bar choices are followed by a separator line. On character-based displays, the separator line is made up of blue dashes. On a graphical display attached to a controller that supports an enhanced interface for nonprogrammable workstations, the separator line is a solid line.