ENTFLDATR (Entry Field Attribute) keyword for display files

You use this field-level, record-level, or file-level keyword to define that the leading attribute of the field changes to a specified attribute whenever the cursor is located in the field.

When defined at both the field- and record-level, the field-level specification is used for the field. The ENTFLDATR keyword is ignored when the workstation is not attached to a controller that supports an enhanced data stream.

The format of the keyword is:

ENTFLDATR[([color] [display attribute] [cursor visible])]

The parameters are optional for the keyword.

The color parameter specifies the color the field will change to when the cursor enters the field 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 white.

The display-attribute parameter specifies the display attributes of the field when the cursor enters the field. 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 is HI.

Note: Display attributes CS, HI, and BL can cause fields on 5292, 3179, 3197 Models C1 and C2, 3487 Models HC, and 3488¹ workstations to appear as color fields. Separator lines will not appear when display attributes HI, RI, and UL are used.

The cursor visible parameter allows the user to specify if the cursor is visible or invisible when it enters the field. *CURSOR means the cursor will stay visible and *NOCURSOR indicates that the cursor will become invisible when it enters the field. *CURSOR is the default. When *NOCURSOR is specified on the ENTFLDATR keyword, the specified field must have an I (inhibit keyword entry) in position 35. If the field does not have data type I, then the default is used for the visible cursor parameter.

The field containing the ENTFLDATR keyword must be an input-capable field. The ENTFLDATR keyword is ignored for the field with DSPATR(PR).

Option indicators are valid for this keyword.

If the ENTFLDATR keyword is specified with the EDTMSK keyword, you might have unpredictable results.

Example

The following example shows how to specify the ENTFLDATR keyword:

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A
     A     R RECORD
     A       F1            10A  B  3  4ENTFLDATR
     A       F2            10A  B 13  4ENTFLDATR((*COLOR RED))
     A       F3            10I  B 16  4ENTFLDATR(*NOCURSOR (*DSPATR HI RI))

In this example, the color turns white, the attribute is high intensity, and the cursor is visible for F1. For F2, the color is red, the attribute is high intensity, and the cursor is visible. For F3, the color is white, the attributes are high intensity and reverse image, and the cursor is not visible.

¹ Dependent on the monitor attached to the display device.