SUBMIT_INTERFACE

Parameter passing with SUBMIT

Variants:

1. ... USING SELECTION-SET vari
2. ... WITH p op f SIGN s
3. ... WITH p BETWEEN f1 AND f2 SIGN s
4. ... WITH p NOT BETWEEN f1 AND f2 SIGN s
5. ... WITH p IN sel
6. ... WITH SELECTION-TABLE seltab
7. ... WITH FREE SELECTIONS texpr

Effect

Passes values to the SELECT-OPTIONS and PARAMETERS of the program rep (these can also be defined in the database program SAPDBldb of the relevant logical database ldb). p is the name of a parameter or selection criterion.

Effect

The variable vari contains the name of a variant used to start the report.

Effect

op is one of the operations EQ, NE, CP, NP, GE, LT, LE, GT. s is a variable which must contain one of the values 'I' or 'E' (any other values result in a runtime error). The addition SIGN is optional and the default is 'I' . If p is a selection criterion ( SELECT-OPTIONS), an entry with LOW = f, OPTION = op and SIGN = s is generated in the relevant internal table.
If p is a parameter ( PARAMETERS ), the system treats all options like EQ, i.e. it always transfers a single value. The field f is passed to the parameter p or to the field p-LOW of the selection criterion (xxx in the above list) in internal format. If p is not the same type as f , a type conversion is performed in the target report when data is passed.

Note

Instead of the option EQ, you can also use = or INCL.

Effect

Passes the range with the lower limit f1 and the upper limit f2 to the selection criterion p. As with variant 2, f1 and f2 are passed in internal format and the handling of SIGN is also the same. The system thus generates an entry with LOW = f1, HIGH = f2, OPTION = BT and SIGN = s. When data is passed, a type conversion is performed.

Effect

Similar to 3, except that OPTION NB is generated instead of OPTION BT.

Effect

p is a selection criterion and sel is an internal table which is compatible with p and contains the transfer values. You are recommended to define sel with RANGES. The lines of sel must have exactly the same structure as the lines of a selection table (see SELECT-OPTIONS).

Effect

seltab is an internal table with the structure RSPARAMS.
This variant allows you to set the names and contents of the parameters and selection options dynamically at runtime.
You can use the function module RS_REFRESH_FROM_SELECTOPTIONS to read the contents of the parameters and selection options of the current program into an internal table seltab with the structure RSPARAMS. By using SUBMIT ... WITH SELECTION-TABLE seltab, you can then pass these values on directly.


texpr is an internal table of the type RSDS_TEXPR (see type pool RSDS).

Note

You can, for example, fill the object texpr in one of the following ways:

You can combine the variants 1-7 in any permutation. The same selection criterion may be addressed several times with WITH . This generates several lines in the internal table assigned to the selection criterion p . You can also combine parameter transfer using a variant with explicit parameter passing via the WITH clause. In the event of a conflict, the following sequence applies:
Firstly, the variant is imported
Secondly, the contents of the selection table are read (WITH SELECTION TABLE)
Finally, the values passed explicitly using WITH are copied.

RANGES RANGE_LANGU FOR SY-LANGU. 
 
PARAMETERS: MSG_FR LIKE T100-MSGNR, 
			MSG_TO LIKE T100-MSGNR. 
 
MOVE: 'I'  TO RANGE_LANGU-SIGN, 
	'BT' TO RANGE_LANGU-OPTION, 
	'D'  TO RANGE_LANGU-LOW, 
	'I'  TO RANGE_LANGU-HIGH. 
APPEND RANGE_LANGU. 
 
MOVE: 'EQ'  TO RANGE_LANGU-OPTION, 
	'E'   TO RANGE_LANGU-LOW. 
APPEND RANGE_LANGU. 
 
SUBMIT REPORT00 
	 USING SELECTION-SET 'VARIANT1' 
	 WITH  MSG   BETWEEN MSG_FR AND MSG_TO 
	 WITH  LANGU IN RANGE_LANGU.

Example

In REPORT00, the contents of variant VARIANT1 appear in all of the parameters and select-options. However, in MSG and LANGU, the explicitly passed values take precedence.

Examples

2nd combination variant, WITH SELECTION-TABLE and explicit WITH clauses.

DATA SELTAB LIKE RSPARMS OCCURS 5 WITH HEADER LINE. 
 
MOVE: 'LANGU' TO SELTAB-SELNAME, 
	'S'	TO SELTAB-KIND, " SELECT-OPTION 
	'I'	TO SELTAB-SIGN, 
	'BT'	 TO SELTAB-OPTION, 
	'D'	TO SELTAB-LOW, 
	'I'	TO SELTAB-HIGH. 
APPEND SELTAB. 
 
MOVE: 'E'	TO SELTAB-SIGN, 
	'EQ'	 TO SELTAB-OPTION, 
	'F'	TO SELTAB-LOW, 
	SPACE	TO SELTAB-HIGH. 
APPEND SELTAB. 
 
CLEAR SELTAB. 
MOVE: 'ARBGB' TO SELTAB-SELNAME, 
	'P'	TO SELTAB-KIND, " PARAMETER 
	'XX'	 TO SELTAB-LOW. 
APPEND SELTAB. 
 
 
SUBMIT REPORT00 
	 USING SELECTION-SET 'VARIANT1' 
	 WITH ARBGB CP 'A*' 
	 WITH  SELECTION-TABLE SELTAB 
	 AND RETURN. 
 
 In REPORT00, the contents of variant VARIANT1 appear in all of the 
parameters and 
select-options. However, 
precedence is taken in LANGU by the contents of SELTAB and in ARBGB by the explicitly-passed value.