Calling Programs

下面ABAP语句允许你调用一个可执行程序或者事务码，调用后你可以直接退出主调程序，或者返回到调用被调程序的地方继续后继代码的执行：

可执行Program                     Transaction

Call (without returning)  SUBMIT                              LEAVE TO TRANSACTION

Call and return             SUBMIT AND RETURN         CALL TRANSACTION

Calling Executable Programs（SUBMIT）

SUBMIT<rep>|(<field>) [AND RETURN] [<options>].

如果省略AND RETURN选项，主调程序的所有数据与所有级别的List都会从 internal session 中删除。在被调程序执行完后，会返回到主调程序启动的地方。

如果带AND RETURN选项，系统将会保持主调程序的所有数，并在被调程序执行完后返回到主调程序调用处（SUBMIT…AND RETURN语句调用处），然后系统会继续执行主调程序SUBMIT…AND RETURN后面的语句。

<options>用来将数据传递给被调程序，有以下方式：

设置选择屏幕参数值（SUBMIT...WITH）

当正常执行一个报表程序时，标准的选择屏幕会显示，这些屏幕选择条件可以是程序自己本身的，也可以是绑定的LDB的屏幕字段。当使用SUBMIT调用时，可以通过各种参数选项来给这些屏幕选择条件填充值：

SUBMIT... [VIA SELECTION-SCREEN]

[USING SELECTION-SET <var>]

[WITH <sel><criterion>]

[WITH FREE SELECTIONS <freesel>]

[WITH SELECTION-TABLE <rspar>].

VIA SELECTION-SCREEN

被调报表程序的选择屏幕会显示。如果此选择打开，并且还使用了其他参数选项来传输值时，这些值也会显示在屏幕中相应的输入框中，并且用户可以进一步修改这些值。在默认的情况下，通过SUBMIT调用时是不会显示可执行程序的选择屏幕的。

USING SELECTION-SET <var>

使用变式<var>。This option tells the system to start the called program with the variant <var>.

WITH <sel><criterion>

使用此选择可以对选择屏幕的某个选择条件<sel>进行单独的赋值，并通过<criterion>部分来具体来决定是SELECT-OPTIONS还是PARAMETERS，<criterion>部分可以为以下三种情况：

l  <op><f> [SIGN <s>], 用来传输屏幕选择条件的单个值

如果<sel>为SELECT-OPTIONS类型的屏幕选择条件，则使用<op>去填充选择内表<sel>的OPTION字段，<f>去填充选择内表<sel>的LOW字段，<s>去填充选择内表<sel>的SIGN字段（注：如果屏幕条件取值为某个范围，则这里<op>不用BT与NB，则使用下面的[NOT] BETWEEN来单独传递）

如果<sel>为PARAMETERS类型的屏幕字段，<op>的值只能是“=”，并将<f>的值赋值给相应屏幕字段<sel>

l  [NOT] BETWEEN <f1> AND <f2> [SIGN <s>], 用来传递范围取值

<f1>会传递给LOW字段，<f2>会传递给HIGH字段，<s>会传递给选择内表<sel>的SIGN字段。如果省略了NOT选项，系统会将OPTION字段设置为BT，如果使用了NOT选项，系统会将OPTION设置为NB。

l  IN <seltab>, 通过条件选择内表（行结构类型与SELECT-OPTION选择条内表行结构相同）传递屏幕参数

该选项会将主调程序中的条件内表<seltab>赋值给被调用程序的条件选择内表<sel>。<seltab>必须是一个条件内表，可以使用RANGES语句来创建。

WITH FREE SELECTION <freesel>, user dialog for dynamic selections动态选择的用户对话

To use this option, both calling and called programs must be connected to a logical

database that supports dynamic selections. In the calling program, use the function

modules FREE_SELECTIONS_INIT and FREE_SELECTIONS_DIALOG. They allow the

user to enter dynamic selections on a selection screen. One export parameter of these

function modules has structure RSDS_TEXPR from the RSDS type group. Transfer the

values of this export parameter by means of the internal table <freesel> of the same

structure to the called report.

要使用此选项，必须将调用报表和被调用报表都连接到支持动态选择的逻辑数据库。在调用报表中，使用功能模块 FREE-SELECTIONS_INIT 和 FREE_SELECTIONS_DIALOG，它们允许用户在选择屏幕上输入动态选择。这些功能块的一个输出参数有 RSDS 类型组中的 RSDS_TEXPR 结构。通过相同结构的内部表<freesel>将此输出参数的值传送到被调用报表。

WITH SELECTION-TABLE <rspar>, dynamic transfer of values

<rspar>内表必须是行结构必须是RSPARAMS结构类型的类型，该结构包含以下字段：

SELNAME：SELECT-OPTION 或者 PARAMETER屏幕字段名称

KIND：如果是SELECT-OPTION时，取值为S，如果PARAMETER时，取值为P。

其他字段与SELECT-OPTION选择条内表行结构相同。

除了WITH SELECTION-TABLE以外，WITH <sel>选项你可以多次使用。在实际应用中，你可以对某个SELECT-OPTION选择条件<sel>使用WITH <sel>选项多次，在被调用程序中，系统会将这些行append到selection tables<sel>中，但如果对某个PARAMETER条件使用多次，则会使用最后一次的值。

实例一：参数传递

.
      APPEND rspar.
      SUBMIT zjzj_rep1 VIA SELECTION-SCREEN
        WITH SELECTION-TABLE rspar
        AND RETURN.
  ENDCASE.

).
SELECT-OPTIONS selecto FOR number.

实例二：参数传递及返回值接收

) VALUE 'JACKYTEST'.

PARAMETERS: p_werks LIKE mard-werks OBLIGATORY.
SELECT-OPTIONS: s_matnr FOR mard-matnr.
PARAMETERS: p_qty AS CHECKBOX.
PARAMETERS: p_type NO-DISPLAY DEFAULT '1'.

START-OF-SELECTION.
  DATA: gt_tabsel LIKE rsparams OCCURS 10 WITH HEADER LINE.
  IF NOT s_matnr[] IS INITIAL.
    LOOP AT s_matnr.
      "selection类型参数需要封装到rsparams类型的内表中才能传递
      MOVE-CORRESPONDING s_matnr TO gt_tabsel.
      "被调用程序中的selection-option参数
      gt_tabsel-selname = 'S_MATNR'.
      gt_tabsel-kind = 'S'.
      APPEND gt_tabsel.
      CLEAR gt_tabsel.
    ENDLOOP.
  ENDIF.
  SUBMIT yjzj_call_prog_9_6 WITH p_werks = p_werks
                          WITH p_qty = p_qty
                          WITH p_type = 'X'
                          "传递selection类型的参数到被调用程序中
                          WITH SELECTION-TABLE gt_tabsel
                          AND RETURN.
  "从被调用程序中导入结果
  IMPORT gt_mard TO gt_mard FROM MEMORY ID g_memory.
  FREE MEMORY ID g_memory.
  LOOP AT gt_mard INTO gx_mard.
    WRITE:/02 gx_mard-matnr,
              gx_mard-werks,
              gx_mard-lgort,
              gx_mard-labst,
              gx_mard-insme.
  ENDLOOP.

.
        DELETE gt_mard INDEX g_tabix.
        CONTINUE.
      ENDIF.
    ENDLOOP.
  ENDIF.
  IF p_type NE space.
    FREE MEMORY ID g_memory.
    "将结果导出到主调用程序
    EXPORT gt_mard FROM gt_mard TO MEMORY ID g_memory.
  ELSE.
    LOOP AT gt_mard INTO gx_mard.
      WRITE:/02 gx_mard-matnr,
                gx_mard-werks,
                gx_mard-lgort,
                gx_mard-labst,
                gx_mard-insme.
    ENDLOOP.
  ENDIF.

控制Called Programs中LISTS输出

当你使用SUBMIT提交一个ABAP program时，你可以控制这个被调程序的输出列表：修改输出行列长度格式、输出到spool file来代替输出到屏幕、或者是将输出列表存储到ABAP memory中。

修改输出LISTS行列数

SUBMIT... [LINE-SIZE<width>] [LINE-COUNT<length>].

如果被调程序的REPORT语句后面没有这LINE-SIZE与LINE-COUNT两个选项，系统将会使用SUBMIT语句后面的这两个选项来格式化输出列表。

.
SET PF-STATUS 'SELECT'.
WRITE: 'Select a report and its list format:',
      / '-------------------------------------'.
SKIP.
WRITE: 'Report ', NAME INPUT ON,
        / 'Line size ', WID INPUT ON,
        / 'Page length', LEN INPUT ON.

AT USER-COMMAND.
CASE SY-UCOMM.
WHEN 'SELE'.
READ LINE: 4 FIELD VALUE NAME,
5 FIELD VALUE WID,
6 FIELD VALUE LEN.
SUBMIT (NAME) LINE-SIZE WID LINE-COUNT LEN AND RETURN.
ENDCASE.

将被调程序的输出列表打印到spool system

SUBMIT... TO SAP-SPOOL<print-parameters>.

可以将被调程序的输出列表直接输出到spool system，而不是显示在屏幕上。

将输出列表保存到ABAP memory

可以使用EXPORTING LIST TO MEMORY选项将被调程序输出列表保存到ABAP内存中（而不是直接显示在屏幕上），供被调程序执行完后，主调程序来使用输出列表：

SUBMIT... AND RETURN EXPORTING LIST TO MEMORY.

将被调程序的输出列表存储到ABAP内存中，可以在被调程序执行完后，主调程序还可以访问它。EXPORTING LIST TO MEMORY选项需要与AND RETURN选项一起使用。并且不能将EXPORTING LIST TO MEMORY选项与TO SAP-SPOOL选项一起使用。

输出列表存到内存里时，会以行类型为ABAPLIST的内表形式保存，可以使用下面这几个Function来访问ABAP内在中保存的输出列表（这些函数都是属于function group SLST）：

LIST_FROM_MEMORY：从ABAP Memory中将ListsLoad到row type ABAPLIST的内表中

WRITE_LIST：将行类型为ABAPLIST 的内表中的内容插入到当前输出列表中.

DISPLAY_LIST：将行类型为ABAPLIST 的内表中的内容显示在独立的list screen中

LIST_TO_ASCI：将行类型为ABAPLIST 的内表中的内容转换ASCII形式

.
  CALL FUNCTION 'WRITE_LIST'
    TABLES
      listobject = list_tab.
ENDIF.

使用LEAVE语句退出被调程序

在通常情况下，我们在被调程序的基础输出列表（Level为0的List屏幕）按F3就会退出该程序。但是，在返回到主调程序之前，在被调程序里需要执行更多的语句，比如需要使用EXPORT语句将被调程序中的数据存储到ABAP memory中便于主调程序使用时，像这样，你可以为Back Function自定义Function Code（不要使用默认的BACK，即要自己重写默认的BACK Function Code），并且在AT USER-COMMAND事件块里对相应的Function Code进行处理，当你将数据存储起来之后，就可以使用LEAVE（因为重写了默认的BACK Function Code，所以需要使用LEAVE语句来以编程方式退出程序）语句来退出当前被调用的程序了：

,
NUM TYPE I.
SUBMIT zjzj2 AND RETURN.
IMPORT ITAB FROM MEMORY ID 'HK'.
LOOP AT ITAB INTO NUM.
  WRITE / NUM.
ENDLOOP.
TOP-OF-PAGE.
  WRITE 'Report 1'.
  ULINE.

注：不要将Function定义成默认的BACK了，否则不会被AT USER-COMMAND事件块捕获到，会使用默认的回退功能。

.
SET PF-STATUS 'MYBACK'.
DO 5 TIMES.
  NUMBER = SY-INDEX.
  APPEND NUMBER TO ITAB.
  WRITE / NUMBER.
ENDDO.
TOP-OF-PAGE.
  WRITE 'Report 2'.
  ULINE.
AT USER-COMMAND.
  CASE SY-UCOMM.
    WHEN 'MBCK'.
     EXPORT ITAB TO MEMORY ID 'HK'."退出前执行一些语句
      LEAVE."离开当前被调程序，返回到主调程序
  ENDCASE.

CALL TRANSACTION、LEAVE TO TRANSACTION

二种方法调用Tcode：

1、 如果调用后不需要返回到主调程序，则可以使用下面这种方式：

LEAVE TO TRANSACTION <tcod>|(<tcod>)[AND SKIP FIRST SCREEN].

该语句会结束当前主调程序去执行事务码<tcod>，并且会将主调程序从internal sessions中删除,而被调用Tcode将会在该external session中新开一个internal session再运行，并且被调程序执行后，并不会回到主调程序调用处继续往下执行，而是the system returns tothe area menu from which the original program in the call stack was started.

2、 如果调用后还要返回到主调程序，则使用下面这种方式：

CALL TRANSACTION <tcod>|(<tcod>)  [AND SKIP FIRST SCREEN] [USING <bdc_tab >].

系统会重新开启一个internal session,当被调程序结束后，被调Tcode所在的这个internal session会被delete掉，然后返回到主调程序调用处，继续运行主调程序后面的语句

<bdc_tab>用在BDC调用输入参数传递，具体请参考ABAP Practical Example App.docx文档

退出程序 Leave Program

LEAVE PROGRAM.

退出整个程序，并删除所在内部会话、包括加载的程序、实例、数据。

Passing Data Between Programs

请参考以下文档：

《数据共享与传递.docx》

《ABAP BC Programming.docx》的程序间数据共享与传递章节