SAP Function Modules

MGW_UTILITIES_MATRIX_SHELL_RA SAP Function module







MGW_UTILITIES_MATRIX_SHELL_RA is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name MGW_UTILITIES_MATRIX_SHELL_RA into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: MGW_UTILITIES_MATRIX
Released Date: Not Released
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM MGW_UTILITIES_MATRIX_SHELL_RA - MGW UTILITIES MATRIX SHELL RA





CALL FUNCTION 'MGW_UTILITIES_MATRIX_SHELL_RA' "
  EXPORTING
    object =                    "
    class_type =                " tcla-klart
    include_header =            " incl_bild
    start_mode =                "
*   titel =                     "
*   nodelist_titel =            "
*   status_prog =               " rsmpe-program
*   status =                    " sy-pfkey
*   button_01 =                 "
*   button_02 =                 "
*   pf3_posi = 'X'              " char1
*   pf8_posi = SPACE            " char1
*   pf11_posi = SPACE           " char1
*   pf12_posi = 'X'             " char1
*   pf15_posi = SPACE           " char1
*   xy_change_posi =            "
*   display_only =              "
*   check_exit =                "
*   subscr = SPACE              "
*   init_matrix = 'X'           " char1
*   skip_axis_sel = SPACE       " char1
*   f4_special_check = SPACE    " char1
*   knsta_gen_nodes = 'D'       " char1
*   function_exit =             " rs38l-name
*   reactivate_nodes = SPACE    " char1
  IMPORTING
    return_functioncode =       "
    mtx_scnr =                  "
  TABLES
*   var_art =                   " mtrx_vart
*   var_wsel =                  " mtrx_wsel
    vb_char =                   " mtrx_char
    vb_val =                    " mtrx_vali
    modes =                     " mtrx_mode
*   list_header =               "
*   ok_codes =                  "
  EXCEPTIONS
    MODE_ERROR = 1              "
    INPUTDATA_ERROR = 2         "
    NO_VALUE = 3                "
    NO_CHAR = 4                 "
    NO_CUOBJ = 5                "
    NO_CLASSIFICATION_FOUND = 6  "
    CLASSIFICATION_ERROR = 7    "
    MATRIX_CANCELLED = 8        "
    .  "  MGW_UTILITIES_MATRIX_SHELL_RA

ABAP code example for Function Module MGW_UTILITIES_MATRIX_SHELL_RA





The ABAP code below is a full code listing to execute function module MGW_UTILITIES_MATRIX_SHELL_RA including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
ld_return_functioncode  TYPE STRING ,
ld_mtx_scnr  TYPE STRING ,
it_var_art  TYPE STANDARD TABLE OF MTRX_VART,"TABLES PARAM
wa_var_art  LIKE LINE OF it_var_art ,
it_var_wsel  TYPE STANDARD TABLE OF MTRX_WSEL,"TABLES PARAM
wa_var_wsel  LIKE LINE OF it_var_wsel ,
it_vb_char  TYPE STANDARD TABLE OF MTRX_CHAR,"TABLES PARAM
wa_vb_char  LIKE LINE OF it_vb_char ,
it_vb_val  TYPE STANDARD TABLE OF MTRX_VALI,"TABLES PARAM
wa_vb_val  LIKE LINE OF it_vb_val ,
it_modes  TYPE STANDARD TABLE OF MTRX_MODE,"TABLES PARAM
wa_modes  LIKE LINE OF it_modes ,
it_list_header  TYPE STANDARD TABLE OF STRING,"TABLES PARAM
wa_list_header  LIKE LINE OF it_list_header ,
it_ok_codes  TYPE STANDARD TABLE OF STRING,"TABLES PARAM
wa_ok_codes  LIKE LINE OF it_ok_codes .

DATA(ld_object) = 'some text here'.

SELECT single KLART
FROM TCLA
INTO @DATA(ld_class_type).

DATA(ld_include_header) = 'Check type of data required'.
DATA(ld_start_mode) = 'some text here'.
DATA(ld_titel) = 'some text here'.
DATA(ld_nodelist_titel) = 'some text here'.

DATA(ld_status_prog) = some text here
DATA(ld_status) = 'some text here'.
DATA(ld_button_01) = 'some text here'.
DATA(ld_button_02) = 'some text here'.
DATA(ld_pf3_posi) = 'some text here'.
DATA(ld_pf8_posi) = 'some text here'.
DATA(ld_pf11_posi) = 'some text here'.
DATA(ld_pf12_posi) = 'some text here'.
DATA(ld_pf15_posi) = 'some text here'.
DATA(ld_xy_change_posi) = 'some text here'.
DATA(ld_display_only) = 'some text here'.
DATA(ld_check_exit) = 'some text here'.
DATA(ld_subscr) = 'some text here'.
DATA(ld_init_matrix) = 'some text here'.
DATA(ld_skip_axis_sel) = 'some text here'.
DATA(ld_f4_special_check) = 'some text here'.
DATA(ld_knsta_gen_nodes) = 'some text here'.

DATA(ld_function_exit) = some text here
DATA(ld_reactivate_nodes) = 'some text here'.

"populate fields of struture and append to itab
append wa_var_art to it_var_art.

"populate fields of struture and append to itab
append wa_var_wsel to it_var_wsel.

"populate fields of struture and append to itab
append wa_vb_char to it_vb_char.

"populate fields of struture and append to itab
append wa_vb_val to it_vb_val.

"populate fields of struture and append to itab
append wa_modes to it_modes.

"populate fields of struture and append to itab
append wa_list_header to it_list_header.

"populate fields of struture and append to itab
append wa_ok_codes to it_ok_codes. . CALL FUNCTION 'MGW_UTILITIES_MATRIX_SHELL_RA' EXPORTING object = ld_object class_type = ld_class_type include_header = ld_include_header start_mode = ld_start_mode * titel = ld_titel * nodelist_titel = ld_nodelist_titel * status_prog = ld_status_prog * status = ld_status * button_01 = ld_button_01 * button_02 = ld_button_02 * pf3_posi = ld_pf3_posi * pf8_posi = ld_pf8_posi * pf11_posi = ld_pf11_posi * pf12_posi = ld_pf12_posi * pf15_posi = ld_pf15_posi * xy_change_posi = ld_xy_change_posi * display_only = ld_display_only * check_exit = ld_check_exit * subscr = ld_subscr * init_matrix = ld_init_matrix * skip_axis_sel = ld_skip_axis_sel * f4_special_check = ld_f4_special_check * knsta_gen_nodes = ld_knsta_gen_nodes * function_exit = ld_function_exit * reactivate_nodes = ld_reactivate_nodes IMPORTING return_functioncode = ld_return_functioncode mtx_scnr = ld_mtx_scnr TABLES * var_art = it_var_art * var_wsel = it_var_wsel vb_char = it_vb_char vb_val = it_vb_val modes = it_modes * list_header = it_list_header * ok_codes = it_ok_codes EXCEPTIONS MODE_ERROR = 1 INPUTDATA_ERROR = 2 NO_VALUE = 3 NO_CHAR = 4 NO_CUOBJ = 5 NO_CLASSIFICATION_FOUND = 6 CLASSIFICATION_ERROR = 7 MATRIX_CANCELLED = 8 . " MGW_UTILITIES_MATRIX_SHELL_RA
IF SY-SUBRC EQ 0. "All OK ELSEIF SY-SUBRC EQ 1. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 2. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 3. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 4. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 5. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 6. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 7. "Exception "Add code for exception here ELSEIF SY-SUBRC EQ 8. "Exception "Add code for exception here ENDIF.







ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:
ld_return_functioncode  TYPE STRING ,
ld_object  TYPE STRING ,
it_var_art  TYPE STANDARD TABLE OF MTRX_VART ,
wa_var_art  LIKE LINE OF it_var_art,
ld_mtx_scnr  TYPE STRING ,
ld_class_type  TYPE TCLA-KLART ,
it_var_wsel  TYPE STANDARD TABLE OF MTRX_WSEL ,
wa_var_wsel  LIKE LINE OF it_var_wsel,
it_vb_char  TYPE STANDARD TABLE OF MTRX_CHAR ,
wa_vb_char  LIKE LINE OF it_vb_char,
ld_include_header  TYPE INCL_BILD ,
it_vb_val  TYPE STANDARD TABLE OF MTRX_VALI ,
wa_vb_val  LIKE LINE OF it_vb_val,
ld_start_mode  TYPE STRING ,
it_modes  TYPE STANDARD TABLE OF MTRX_MODE ,
wa_modes  LIKE LINE OF it_modes,
ld_titel  TYPE STRING ,
it_list_header  TYPE STANDARD TABLE OF STRING ,
wa_list_header  LIKE LINE OF it_list_header,
ld_nodelist_titel  TYPE STRING ,
ld_status_prog  TYPE RSMPE-PROGRAM ,
it_ok_codes  TYPE STANDARD TABLE OF STRING ,
wa_ok_codes  LIKE LINE OF it_ok_codes,
ld_status  TYPE SY-PFKEY ,
ld_button_01  TYPE STRING ,
ld_button_02  TYPE STRING ,
ld_pf3_posi  TYPE CHAR1 ,
ld_pf8_posi  TYPE CHAR1 ,
ld_pf11_posi  TYPE CHAR1 ,
ld_pf12_posi  TYPE CHAR1 ,
ld_pf15_posi  TYPE CHAR1 ,
ld_xy_change_posi  TYPE STRING ,
ld_display_only  TYPE STRING ,
ld_check_exit  TYPE STRING ,
ld_subscr  TYPE STRING ,
ld_init_matrix  TYPE CHAR1 ,
ld_skip_axis_sel  TYPE CHAR1 ,
ld_f4_special_check  TYPE CHAR1 ,
ld_knsta_gen_nodes  TYPE CHAR1 ,
ld_function_exit  TYPE RS38L-NAME ,
ld_reactivate_nodes  TYPE CHAR1 .

ld_object = 'some text here'.

"populate fields of struture and append to itab
append wa_var_art to it_var_art.

SELECT single KLART
FROM TCLA
INTO ld_class_type.


"populate fields of struture and append to itab
append wa_var_wsel to it_var_wsel.

"populate fields of struture and append to itab
append wa_vb_char to it_vb_char.
ld_include_header = 'some text here'.

"populate fields of struture and append to itab
append wa_vb_val to it_vb_val.
ld_start_mode = 'some text here'.

"populate fields of struture and append to itab
append wa_modes to it_modes.
ld_titel = 'some text here'.

"populate fields of struture and append to itab
append wa_list_header to it_list_header.
ld_nodelist_titel = 'some text here'.

ld_status_prog = some text here

"populate fields of struture and append to itab
append wa_ok_codes to it_ok_codes.
ld_status = 'some text here'.
ld_button_01 = 'some text here'.
ld_button_02 = 'some text here'.
ld_pf3_posi = 'some text here'.
ld_pf8_posi = 'some text here'.
ld_pf11_posi = 'some text here'.
ld_pf12_posi = 'some text here'.
ld_pf15_posi = 'some text here'.
ld_xy_change_posi = 'some text here'.
ld_display_only = 'some text here'.
ld_check_exit = 'some text here'.
ld_subscr = 'some text here'.
ld_init_matrix = 'some text here'.
ld_skip_axis_sel = 'some text here'.
ld_f4_special_check = 'some text here'.
ld_knsta_gen_nodes = 'some text here'.

ld_function_exit = some text here
ld_reactivate_nodes = 'some text here'.

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name MGW_UTILITIES_MATRIX_SHELL_RA or its description.