SFLRTNSEL (Subfile Return Selected Choices) keyword for display files

You use this record-level keyword on a selection-list subfile control record to control how choices are returned to the application with the GET-NEXT-CHANGED operation.

This keyword has no parameters.

If this keyword is specified then SFLMLTCHC or SFLSNGCHC must be specified.

Specifying this keyword causes the GET-NEXT-CHANGED operation to return all selected choices. This includes default choices, which did not actually change. For example, the user never specifically selected the choice.

If this keyword is not specified, only the changed records will be returned to the application by the GET-NEXT-CHANGED operation. This means that a default selection will not be returned because that choice was not changed by the user.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the SFLRTNSEL 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                                      SFLRTNSEL
     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'Single selection list:'
     A

In this example, the GET-NEXT-CHANGED operation returns all selected choices. This includes default choices, which did not actually change, for example, when the user never specifically selected the choice.