SFLCHCCTL (Subfile Choice Control) keyword for display files
You use this field-level keyword on a selection list to control the availability of choices for the list.
The format of the keyword is SFLCHCCTL
.
When the SFLCHCCTL keyword is specified on a field, that field will be considered the control field for that record. That field must be the first field defined in the subfile record. That field must have a length of 1, data type of Y, decimal positions of zero, and have a usage of H. That field must be defined as the first field in the subfile. The control field works as follows:
Control value | Meaning on output | Meaning of input |
---|---|---|
0 | Available | Not selected |
1 | Selected | Selected |
2 | Unavailable. Cannot place cursor on choice unless help for choice is available.1 | |
3 | Unavailable. Placing cursor on choice is allowed. | |
4 | Unavailable. Cannot place cursor on choice even if help for the choice is available.1 |
Option indicators are not valid for this keyword.
SFLNXTCHC keyword cannot be specified in a record that contains a field with the SFLCHCCTL keyword.
Only one SFLCHCCTL keyword can be used in one subfile record.
Example
The following example shows how to specify the SFLCHCCTL keyword.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R SFLRCD SFL
A CTLFLD 1Y 0H SFLCHCCTL
A F1 4A O 6 10
A R SFLCTLRCD SFLCTL(SFLRCD)
A SFLMLTCHC
A SFLPAG(5) SFLSIZ(&SFLSIZ);
A SFLDSP SFLDSPCTL
A ROLLUP(10)
A 10 SFLEND(*SCRBAR)
A F3 5S 0H SFLSCROLL
A F2 4S 0H SFLRCDNBR(CURSOR *TOP)
A SFLSIZ 5S 0P
A 1 30'Panel Title'
A 4 5'Multiple selection list:'