Use this field-level keyword on a selection list to control the availability of choices for the list.
The format of the keyword is the following:
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 11. 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.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 can not 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:'
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.