MNUBARSW (Menu-Bar Switch Key) keyword for display files

You use this file- or record-level keyword to assign a command attention (CA) key to be the Switch-to-menu-bar key.

If the menu-bar switch key is active and a menu bar is displayed, pressing the CA key will do one of the following tasks:

If the cursor is located on the application record, pressing the switch key moves the cursor to the first field in the menu bar.
If the cursor has been moved to the menu bar using the switch key, pressing the switch key again moves the cursor back to the location where the cursor was when the switch key was pressed to move the cursor into the menu bar.
If the cursor has been moved to the menu bar manually (for example, using the cursor movement keys), pressing the switch key moves the cursor to the first input-capable field in the application record.

The format of the keyword is MNUBARSW [(CAnn)].

The CAnn parameter is optional. If not specified, the default is CA10. Valid values for the CAnn parameter are CA01 through CA24.

Within a record, the CAnn key specified by the MNUBARSW keyword cannot be specified again using another keyword (such as MNUCNL). Because MNUBARSW at the file level extends to all records in the file, this must be considered when assigning a CAnn key.

If the MNUBARSW keyword is specified on the record, the CAnn key or default CA10 key can be used only as a CA key on other records, not as a CF key.

The MNUBARSW keyword is allowed only in a file containing a menu-bar record.

Option indicators are valid for this keyword.

Example

The following example shows how to specify the MNUBARSW keyword:

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A                                      MNUBARSW(CA10)
     A          R MENUBAR                   MNUBAR
     A            MNUFLD         2Y 0B  1  2
     A                                      MNUBARCHC(1 PULLFILE +
     A                                          '>File        ')
     A  01                                  MNUBARCHC(2 PULLEDIT +
     A                                          '>Edit        ')
     A
     A          R PULLEDIT                  PULLDOWN
     A            F1            1D 0B  1   2RANGE(1 3)
     A                                  1  5'1. Undo        '
     A                                  2  4'2. Mark        '
     A                                  3  4'3. Copy        '
     A            :
     A            :
     A          R APPSCR                    MNUBARDSP(MENUBAR &MNUCHOICE);
     A            FIELD1        10A  B 10 12
     A            FIELD2         5S 0B 14 12
     A                                 24  1'F12=Cancel '
     A            MNUCHOICE      2S 0H
     A

In this example, CA10 is defined as the Switch-to-menu-bar key for all records in the file. When the cursor is located anywhere except in the menu bar and CA10 is pressed, the cursor is moved to the File choice on the menu bar. If CA10 is pressed again while the cursor is located anywhere in the menu bar, the cursor is moved back to its previous location within the APPSCR record.