DDS for display files


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


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]