CALL SELECTION-SCREEN

Syntax

CALL SELECTION-SCREEN dynnr
                      [STARTING AT col1 lin1
                      [ENDING   AT col2 lin2]]
                      [USING SELECTION-SET variant].

Extras:

1. ... STARTING AT col1 lin1 [ENDING AT col2 lin2]

2. ... USING SELECTION-SET variant

Effect

This statement calls the Selection Screen with the Dynpro-Number specified in dynnr and starts the Selection Screen Processing. For dynnr a data object of the type n and the length 4 is expected.

The statement CALL SELECTION-SCREEN accesses the selection screens of the respective Main Program of the current program group and these work with the parameters and selection screens 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 subprogram. An uncatchable exception occurs 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, particularly the standard selection screen. Default setting is the display of the selection screen in the window of the preceding screen.

System Fields

sy-subrc	relevance
0	The user selected the function Execute or Execute + Print on the selection screen.
4	The user selected exit or Cancel on the selection screen Back.

Notes

The statement CALL SCREEN is not to be used to call selection screens, as 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 WINDOW when specifying the selection screen.

Addition 1

... STARTING AT col1 lin1 [ENDING AT col2 lin2]

Effect

With the addition STARTING AT, you create 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 col1 and lin1 for column and row. These values refer to the window with the Pop-up-Level 0. The lower right corner is either set automatically or can be specified in col2 and lin2 after ENDING AT. For col1, lin1, col2 and lin2, data objects of the type i are expected. The values of col1, lin1 should be smaller than col2, lin2; Otherwise the behavior will be undefined.

Addition 2

... USING SELECTION-SET variant

Effect

With the addition USING SELECTION-SET, you populate the parameters and selection criteria of the selection screen with the Variant, specified in variant . The transfer of the values to the respective data objects of the program take place immediately before the event ATSELECTION-SCREEN OUTPUT. For variant, you have to specify a character-type data object which at the execution of the statement contains the name of a variant of the main program in capital letters that was stored for the selection screen. If you specify a non-existing variant or a variant of another selection screen of the main program, then the addition is ignored.

Example

Refer to the example in SELECTION-SCREEN BEGIN OF SCREEN .