CALL SELECTION-SCREEN dynnr
[STARTING AT col1 lin1
[ENDING AT col2 lin2]]
[USING SELECTION-SET variant].
CALL SELECTION-SCREEN accesses the selection screens of the respective
main program of the current
program group. These screens work with the parameters and selection criteria of the main program and
trigger the selection screen processing in the main program. The main program is generally the current
program, except for the case when calling a selection screen in an externally called subroutine. An
unhandleable exception is raised if the specified selection screen is not contained in the main program of the program group.
You can call any selection screen of the main program, in particular the standard selection screen. The default setting is the display of the selection screen in the window of the preceding screen.
|0||The user selected the function Execute or Execute + Print on the selection screen.|
|4||User chose Back, Exit, or Cancel on the selection screen.|
CALL SCREENcannot be used to call selection screens, since otherwise the proper execution of the selection screen processing cannot be guaranteed.
If the called selection screen is displayed in a dialog window, we recommend that you use the addition
AS WINDOWwhen specifying the selection screen.
... STARTING AT col1 lin1 [ENDING AT col2 lin2]
STARTING AT creates a modal dialog box and the selection screen
is displayed in it. The upper left corner of the dialog box is determined by the values in
lin1 for column and row. These values refer to the window with the
popup level 0. The lower
right corner is either set automatically or can be specified in
ENDING AT. For
data objects of the type
i are expected. The values of
lin1 should be smaller than
lin2; Otherwise the behavior will be undefined.
... USING SELECTION-SET variant
USING SELECTION-SET populates the parameters and selection criteria of the selection screen with the values of a
variant specified in
variant . The values are passed to the associated data objects of the program immediately before
variant expects a
object which, when the statement is executed, contains the name of a variant of the main program
stored for the selection screen in uppercase. If you specify a nonexistent variant or a variant of another selection screen of the main program, then the addition is ignored.
See the example in
SELECTION-SCREEN BEGIN OF SCREEN.