SUBMIT

Short Reference

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