Skip to content

ABAP Keyword Documentation →  ABAP − Reference →  Calling and leaving program units →  Calling Programs →  Calling Executable Programs →  SUBMIT 

SUBMIT - selscreen_options

Other versions: 7.31 | 7.40 | 7.54

Syntax


... [USING SELECTION-SCREEN dynnr] 
    [VIA SELECTION-SCREEN]
    [selscreen_parameters] ...

Extras

1. ... USING SELECTION-SCREEN dynnr

2. ... VIA SELECTION-SCREEN

Effect

The addition USING SELECTION-SCREEN specifies the selection screen and VIA SELECTION-SCREEN specifies whether it is displayed. The additions selscreen_parameters provide values for the parameters, selection criteria, and the free selection of the called selection screen.

The values are passed to the selection screen between the events INITIALIZATION and AT SELECTION SCREEN OUTPUT. The following hierarchy applies to the passing of the values:

  • First, the selection screen variant of the addition USING SELECTION-SET is passed and this sets all parameters and selection criteria to the values of the variant. The values previously set in the called program are overwritten.
  • The values of the table of the addition WITH SELECTION-TABLE are then passed. All parameters and selection criteria are overwritten accordingly.
  • Finally, the values of the additions WITH sel value are passed. All parameters and selection criteria are overwritten accordingly. If the addition WITH sel value is used more than once for the same parameter, this parameter is overwritten with the last specified value. If the addition WITH sel value is used more than once for the same selection criterion, a ranges table with the corresponding number of rows is passed.
  • Free selections are filled independently of this hierarchy.


    Notes

    • The options for parameter passing enable a selection screen to be viewed as a parameter interface of an executable program. This applies in particular to background selection screen processing and to parameters and selection criteria defined without screen elements using the addition NO-DISPLAY
    • When data is passed, any adjustments made to the screen format, such as abbreviations or the execution of conversion routines, should not be executed for fields for which there are no screen elements on the selection screen. This applies to all parameters and selection criteria defined with NO DISPLAY. It also applies to all rows in a ranges table with the exception of the first row.
    • The additions selscreen_parameters only work the first time the called program is executed. If a selection screen is displayed in the called program, the runtime environment calls the program again after it ends. This replaces the values specified in selscreen_parameters with the previous input values.

    Addition 1

    ... USING SELECTION-SCREEN dynnr

    Effect

    This addition defines which selection screen is called. dynnr is a data object that must contain the dynpro number of a selection screen defined in the called program when the statement SUBMIT is executed.

    • If the addition USING SELECTION-SCREEN is omitted or the dynpro number 1000 is entered, the standard selection screen is called. If no standard selection screen is defined in the called program, no selection screen is called.
    • If a dynpro number other than 1000 is entered in the addition USING SELECTION-SCREEN, the corresponding standalone selection screen is called. If no selection screen with this dynpro number is defined in the called program, a non-handleable exception is raised.

    Addition 2

    ... VIA SELECTION-SCREEN

    Effect

    If this addition is specified, the selection screen is displayed on the screen. Otherwise, background selection screen processing takes place. In background selection screen processing, the selection screen events are raised without the selection screen being displayed.

    Executable Example

    Program Calls, Filling the Selection Screen

    Continue

    SUBMIT - selscreen_parameters

    Program Calls, Filling the Selection Screen