Sign in

docs DDS Display

MNUBARSEP (Menu-Bar Separator) keyword for display files

MNUBARSEP (Menu-Bar Separator) keyword for display files

You use this field-level keyword on a menu-bar field to specify the color, display attributes, or the character that is used to form the menu-bar separator line.

The format of the keyword is:

MNUBARSEP([color] [display-attribute] [character])

One parameter must be specified.

The color parameter specifies the color of the separator characters on a color workstation. The parameter is specified as an expression of the form (*COLOR value).

The valid values for the color parameter are:

Value : Meaning

BLU : Blue

GRN : Green

PNK : Pink

RED : Red

TRQ : Turquoise

YLW : Yellow

WHT : White

If the color parameter is not specified, the default is blue. This parameter is ignored if it is specified for a menu bar on a monochrome display.

The display-attribute parameter specifies the display attributes of the separator characters. The parameter is specified as an expression of the form (*DSPATR value1 <value2 <value3…>>).

The valid values for the display attributes are:

Value : Meaning

BL : Blink

CS : Column separator

HI : High intensity

ND : Nondisplay

RI : Reverse image

UL : Underline

The default display attribute for the menu-bar separator is normal (or low) intensity.

Note: Display attributes CS, HI, and BL can cause fields on 5292, 3179, 3197 Model C1 and C2, 3487 Models HC, and 34881 workstations to appear as color fields. Display attributes HI, RI, and UL cause a separator line not to be displayed.

The character parameter specifies the character that makes up the separator line. The parameter is specified as an expression of the form (*CHAR ‘separator-character’). The separator-character value is one character. If this parameter is not specified, the default separator character is a dash (-) or on a graphical device this shows as a solid line. Although any displayable character can be specified as the separator character, it is recommended that you use invariant characters.

The following figure shows the invariant characters:


Table 1. Character set for system data

HexadecimalCharacterDescription
40Blank
4B.Period
4C<Less-than sign
4D(Left parenthesis
4E+Plus sign
50&Ampersand
5C*Asterisk
5D)Right parenthesis
5E;Semicolon
60-Minus sign
61/Slash
6B,Comma
6C%Percent sign
6D_Underline
6E>Greater-than sign
6F?Question mark
7A:Colon
7DApostrophe
7E=Equal sign

Note: In addition, you can use any of the following characters:

  • Uppercase alphabetic characters: A through Z
  • Numeric characters: 0 through 9

When the MNUBARSEP keyword is specified on a field, the MNUBAR keyword must also be specified on the associated record. The *NOSEPARATOR parameter cannot be used on the MNUBAR keyword if the MNUBARSEP keyword is specified.

Option indicators are valid for this keyword.

If more than one COLOR keyword is specified, the color parameter, display attribute, and separator character are taken from the first keyword that was specified.

Example

The following example shows how to specify the MNUBARSEP keyword:

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A
     A          R MENUBAR                   MNUBAR
     A            MNUFLD         2Y 0B  1  2
     A                                      MNUBARSEP((*COLOR PNK) +
     A                                      (*DSPATR RI) (*CHAR  ' '))
     A                                      MNUBARCHC(1 PULLFILE +
     A                                         'File         ')
     A                                      MNUBARCHC(2 PULLEDIT +
     A                                         'Edit         ')
     A

In this example, the menu-bar separator is made up of pink blanks displayed in reverse image.

1 Dependent on the monitor attached to the display device.