SFLCHCCTL (Subfile Choice Control) keyword for display files

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:

Table 1. Control field for the SFLCHCCTL keyword
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.¹
3	Unavailable. Placing cursor on choice is allowed.
4	Unavailable. Cannot place cursor on choice even if help for the choice is available.¹
¹ Applies only to displays attached to a controller that supports an enhanced interface for nonprogrammable workstations.

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:'