Syntax diagram

SUBMIT

Syntax

SUBMIT {rep|(name)} [selscreen_options]

                    [list_options]

                    [job_options]

                    [AND RETURN].

Addition:

... AND RETURN

Effect

The SUBMIT statement accesses an
executable program rep. The executable program is executed as described under
Calling Executable Reports.

The program name rep can either be specified directly or as the content of a character-like data object
name. The data object
name must contain the name of the program to be accessed in block capitals. If the program specified in
name is not found, an irretrievable exception is generated.

• The selscreen_options additions can be used to determine the
  selection screen for the program accessed and to supply it with values.

• The list_options additions allow you to influence the output medium and the page size in the basic list for the program accessed.
• You can schedule the program for background processing by specifying
  job_options.

Addition

... AND RETURN

Effect

The AND RETURN addition determines the object accessed by the runtime environment after program access is completed:

• Without the AND RETURN addition, the
  internal session of the program accessed replaces the internal session of the calling program in the same position in the
  call sequence. Once program access is completed, the system returns to before the position from which the calling program was started.
  
  As of Release 6.10, the content of the system field sy-calld at
  SUBMIT is copied by the calling program without
  AND RETURN. Before 6.10, the system entered the value "X", which was incorrect when the program was accessed from the first program in a call sequence.

• The addition AND RETURN starts the executable program in a new internal session. The session for the calling program is retained. Once program access is completed, program execution
  for the calling program continues after the SUBMIT statement.
  

Note

When the SUBMIT statement is executed, the system runs an authorization check for the authorization group specified in the
program attributes.

Exceptions

Non-Catchable Exceptions

• Cause: The specified program was not found.
  
  Runtime Error: LOAD_PROGRAM_NOT_FOUND
  
• Cause: You tried to transfer an invalid value to a selection using the addition
  SIGN.
  
  Runtime Error: SUBMIT_WRONG_SIGN
  
• Cause: The specified program is not a report.
  
  Runtime Error: SUBMIT_WRONG_TYPE
  
• Cause: You tried to transfer more than one value to a report parameter.
  
  Runtime Error: SUBMIT_IMPORT_ONLY_PARAMETER
  
• Cause: You tried to use WITH sel IN itab to transfer a table that does not have the appropriate structure to a selection.
  
  Runtime Error: SUBMIT_IN_ITAB_ILL_STRUCTURE
  
• Cause: You tried to transfer a parameter that cannot be converted to the target field to the selection screen.
  
  Runtime Error: SUBMIT_PARAM_NOT_CONVERTIBLE