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 3488¹ 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
Hexadecimal	Character	Description
40		Blank
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
7D	'	Apostrophe
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.

¹ Dependent on the monitor attached to the display device.