SAP NetWeaver AS ABAP Release 740, ©Copyright 2014 SAP AG. All rights reserved.
ABAP Keyword Documentation → ABAP − Reference → Calling and leaving program units → Calling ABAP Programs → Calling Executable Programs → SUBMIT → SUBMIT - selscreen_options →
SUBMIT - selscreen_parameters
Syntax
... [USING SELECTION-SET variant]
[USING SELECTION-SETS OF PROGRAM prog]
[WITH SELECTION-TABLE rspar]
[WITH expr_syntax1 WITH expr_syntax2 ...]
[WITH FREE SELECTIONS texpr] ... .
Extras:
1. ... USING SELECTION-SET variant
2. ... USING SELECTION-SETS OF PROGRAM prog
3. ... WITH SELECTION-TABLE rspar
4. ... WITH expr_syntax1 WITH expr_syntax2 ...
5. ... WITH FREE SELECTIONS texpr
Effect
USING SELECTION-SET supplies all the selection screen components by means of a
Variant variant.
If you specify USING SELECTION-SETS OF PROGRAM, you can use a variant from
a different program; if you specify WITH SELECTION-TABLE, values for several
selection screen components are transferred as the content of an internal table rspar;
WITH expr_syntax supplies individual selection screen components with values. The addition WITH FREE SELECTIONS allows you to transfer free selections to the
selection screen for a
logical database.
... USING SELECTION-SET variant
Effect
If you specify this edition, the parameters and selection criteria for the selection screen are supplied with values from a
variant. For variant,
you must specify a character-type data object that contains the name of a variant for the program accessed when the statement is executed. If the variant does not exist, the system sends an
error message. If the variant belongs to a different selection screen, it is ignored.
Note
You can create and manage variants for every program in which selection screens are defined, either in the
ABAP Workbench or during execution of the program by choosing Goto - Variants on a selection screen.
... USING SELECTION-SETS OF PROGRAM prog
Effect
If you specify this addition, the variants of the program prog are used in the program accessed. For prog, you must specify a character-type data object that contains the name of a program when the statement is executed. The addition has the following effect:
Note
The program prog should contain a selection screen that has the same parameters and selection criteria as the selection screen used in the program accessed.
... WITH SELECTION-TABLE rspar
Effect
If you specify this addition, parameters and selection criteria on the selection screen are supplied from an internal table rspar. You must specify a standard table with row type RSPARAMS or RSPARAMSL_255 and without secondary table keys for rspar. The structured data types RSPARAMS and RSPARAMSL_255 are defined in the ABAP Dictionary and have the following components, all of which are data type CHAR:
To supply parameters and selection criteria for the selection screen with specific values, the rows in the internal table rspar must contain the following values:
If the name of a selection criterion is repeated in rspar, this defines a
selection table containing several rows and passes it on to the selection criterion. If parameter names occur several times, the last value is passed on to the parameter.
The contents of the parameters or selection tables for the current program can be entered in the table by the function module RS_REFRESH_FROM_SELECTOPTIONS.
Notes
... WITH expr_syntax1 WITH expr_syntax2 ...
Effect
This addition supplies values to individual parameters or selection criteria for the selection screen. Parameters are supplied with single values and selection criteria with selection tables that overwrite values already specified in the program accessed. The selection table to be transferred is compiled from all the expr_syntax additions that address the same selection criterion sel. You can specify the following statements for expr_syntax, where you have to specify the name of a parameter or a selection criterion directly for sel:
You can specify the addition expr_syntax more than once, and you can also specify the same selection screen component more than once.
Notes
Example
The program report1 has a stand-alone
selection screen with the
screen number 1100. In
the program report2, an internal table with row type RSPARAMS and a ranges
table are filled for this selection screen. These are transferred at SUBMIT together with a single condition.
Program accessed
Calling program
Result
After report1 has been accessed by
report2, the selection tables for the selection criteria selcrit1 and selcrit2 in the program accessed contain the following entries:
SIGN | OPTION | LOW | HIGH | |
selcrit1 | I | EQ | ABAP | |
selcrit2 | I | BT | H | K |
selcrit2 | E | EQ | H | |
selcrit2 | E | EQ | K |
... WITH FREE SELECTIONS texpr
Effect
This addition supplies values to the dynamic selections for the
selection screen for a
logical database.
The program accessed must be linked to a logical database that supports dynamic selections. texpr must be an internal table of the type RSDS_TEXPR from
type group RSDS.
In texpr, the selections for the dynamic selections are specified in an internal
format (Reverse Polish Notation). You can use function modules FREE_SELECTIONS_INIT, FREE_SELECTIONS_DIALOG,
and FREE_SELECTIONS_RANGE_2_EX from the function group SSEL
to fill texpr in the calling program. Whereas the first two function modules execute a user dialog (see
Dynamic Selections), you can transfer
ranges tables to FREE_SELECTIONS_RANGE_2_EX
for each node in the dynamic selection in an internal table of the type RSDS_TRANGE. These are then
converted to a table of the row type RSDS_TEXPR. If the calling program contains a selection screen
with the same dynamic selections, you can transfer its content beforehand to a table of the type RSDS_TRANGE using the function module RS_REFRESH_FROM_DYNAMICAL_SEL.
The rows in the internal table type RSDS_TRANGE contain a
flat component TABLENAME for each
node and a table-like component FRANGE_T of the type RSDS_FRANGE_T for the fields in the node. The rows
in RSDS_FRANGE_T contain a flat component FIELDNAME for each field and a table-like component SELOPT_T
of the row type RSDSSELOPT from the ABAP Dictionary. RSDSSELOPT contains the four components SIGN, OPTION, LOW, and HIGH and can include the ranges table.
Example
Program report1 is linked to the logical database F1S, which supports dynamic
selections for the node SPFLI. Program report2 enters conditions in a nested
internal table of the type rsds_trange with selection conditions for field
CONNID in node SPFLI; this is then converted to a table of the type rsds_texpr, which is transferred at SUBMIT.
Program accessed
Calling program