---

SAP NetWeaver AS ABAP Release 752, ©Copyright 2017 SAP AG. All rights reserved.

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

SUBMIT - selscreen_options

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:

1. 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.
   
2. The values of the table of the addition WITH SELECTION-TABLE are then passed. All parameters and selection criteria are overwritten accordingly.
   
3. 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 selection 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 selection 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