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.
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 |
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.