CHGINPDFT (Change Input Default) keyword for display files

You use this file-level, record-level, or field-level keyword to change one or more input defaults for input-capable fields.

Without parameter values, this keyword removes the underline for input-capable fields (input only or input/output). With parameter values, this keyword applies the specified display attributes or keyboard controls to the affected input-capable fields.

The format of the keyword is:
CHGINPDFT[(input-default1 input-default2 . . .)]

Valid parameter values for this keyword are:

Parameter value Equivalent DDS keyword Meaning
None DSPATR(UL) specified but not selected Remove underline
BL DSPATR(BL) Blinking field
CS DSPATR(CS) Column separators
HI DSPATR(HI) High intensity
RI DSPATR(RI) Reverse image
UL DSPATR(UL) Underline
FE CHECK(FE) Field exit
LC CHECK(LC) or LOWER Lowercase
ME CHECK(ME) Mandatory enter
MF CHECK(MF) Mandatory fill
Note: If DSPATR(UL) is specified for a field, the CHGINPDFT keyword cannot control underlining for that field.

The above equivalent DDS keywords apply only to output fields. For input and both fields, DSPATR(UL) must also be specified but not selected in addition to the equivalent keywords. This is because DSPATR(UL) is applied to input and both fields by default when CHGINPDFT is not specified.

Two common ways to use this keyword are to allow lowercase data entry for all input-capable fields in a record format or file, and to specify column separators for all input-capable fields in a record format or file.

At the file level, this keyword applies to all input-capable fields in the file. At the record level, this keyword applies to all input-capable fields in the record format. At the field level, this keyword applies only to the fields for which it is specified.

If you specify the CHGINPDFT keyword at more than one level, the lower level keyword overrides the higher level keyword. Thus, specifying CHGINPDFT(BL) at the file level and CHGINPDFT(HI) for a record format causes all input-capable fields in the file except those in that record format to blink. In that record format, all input-capable fields are highlighted.

The CHGINPDFT keyword can be specified with any CHECK or DSPATR keyword. If you specify CHGINPDFT at the file, record, or field level, you can add check codes or display attributes to single fields by specifying CHECK or DSPATR at the field level. For instance, if you specify CHGINPDFT(CS) at the record level and DSPATR(HI) at the field level, the field is displayed with column separators and is highlighted. In addition, the CHECK or DSPATR keyword at the field level controls the check code or display attribute specified with it. For example, if you specify CHGINPDFT(CS) at the record level and DSPATR(CS) with option indicators at the field level, the setting of the option indicators controls the column separators for the field.

If you display a field with UL, RI, and HI in effect, no matter whether specified on the CHGINPDFT keyword, the DSPATR keyword, or a combination of both, the field is not displayed.

When specified at the file or record level, CHGINPDFT(LC) does not apply to numeric fields. If specified for a numeric field, CHGINPDFT(LC) is ignored.

CHGINPDFT(MF) is not allowed with CHECK(RB), CHECK(RZ), AUTO(RAB), AUTO(RAZ), or WRDWRAP keyword.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the CHGINPDFT keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A          R RECORD1                   CHGINPDFT
00020A            FLD1          10   B  1  2
00030A            FLD2          10      2  2
00040A          R RECORD2                   CHGINPDFT(CS)
00050A            FLD3          10   I  3  2
00060A            FLD4          10   B  4  2
00070A            FLD5          10   B  5  2
00080A  01                                  DSPATR(CS)
00090A            FLD6          10      6  2
00100A          R RECORD3                   CHGINPDFT(CS)
00110A            FLD7          10   I  7  2
00120A            FLD8          10   I  8  2
00130A  02                                  DSPATR(HI)
     A

CHGINPDFT is specified at the record level for RECORD1, RECORD2, and RECORD3:

  • For RECORD1, CHGINPDFT removes the underline for FLD1.
  • For RECORD2, CHGINPDFT can have the following results:
    • FLD3 and FLD4 have column separators.
    • FLD5 has column separators only when DSPATR(CS) is selected.
    • FLD6 (an output-only field) has no column separators.
  • For RECORD3, CHGINPDFT can have the following results:
    • FLD7 and FLD8 have column separators.
    • FLD8 is also highlighted when DSPATR(HI) is selected.