SAP Function Modules

DD_MCID_GET SAP Function module - Read a matchcode ID







DD_MCID_GET 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 DD_MCID_GET into the relevant SAP transaction such as SE37 or SE80.

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


Pattern for FM DD_MCID_GET - DD MCID GET





CALL FUNCTION 'DD_MCID_GET' "Read a matchcode ID
  EXPORTING
*   get_state = 'M    '         " dcmcidget     Read status ('A', 'M')
*   langu = SY-LANGU            " sy-langu      Language of texts
    mcid_name =                 " dd23l-mcid    Name of matchcode ID to be read
    mco_name =                  " dd23l-mconame  Name of matchcode object to be read
*   prid = 0                    " sy-tabix      ID of the error output channel
*   withtext = SPACE            " ddrefstruc-bool  <> SPACE: texts are read
  IMPORTING
    dd23v_wa_a =                " dd23v
    dd23v_wa_n =                " dd23v
    got_state =                 " dcmcidget
* TABLES
*   dd24v_tab_a =               " dd24v
*   dd24v_tab_n =               " dd24v
*   dd21v_tab_a =               " dd21v
*   dd21v_tab_n =               " dd21v
*   dd28v_tab_a =               " dd28v
*   dd28v_tab_n =               " dd28v
  EXCEPTIONS
    ACCESS_FAILURE = 1          "
    .  "  DD_MCID_GET

ABAP code example for Function Module DD_MCID_GET





The ABAP code below is a full code listing to execute function module DD_MCID_GET 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_dd23v_wa_a  TYPE DD23V ,
ld_dd23v_wa_n  TYPE DD23V ,
ld_got_state  TYPE DCMCIDGET ,
it_dd24v_tab_a  TYPE STANDARD TABLE OF DD24V,"TABLES PARAM
wa_dd24v_tab_a  LIKE LINE OF it_dd24v_tab_a ,
it_dd24v_tab_n  TYPE STANDARD TABLE OF DD24V,"TABLES PARAM
wa_dd24v_tab_n  LIKE LINE OF it_dd24v_tab_n ,
it_dd21v_tab_a  TYPE STANDARD TABLE OF DD21V,"TABLES PARAM
wa_dd21v_tab_a  LIKE LINE OF it_dd21v_tab_a ,
it_dd21v_tab_n  TYPE STANDARD TABLE OF DD21V,"TABLES PARAM
wa_dd21v_tab_n  LIKE LINE OF it_dd21v_tab_n ,
it_dd28v_tab_a  TYPE STANDARD TABLE OF DD28V,"TABLES PARAM
wa_dd28v_tab_a  LIKE LINE OF it_dd28v_tab_a ,
it_dd28v_tab_n  TYPE STANDARD TABLE OF DD28V,"TABLES PARAM
wa_dd28v_tab_n  LIKE LINE OF it_dd28v_tab_n .

DATA(ld_get_state) = 'Check type of data required'.
DATA(ld_langu) = 'Check type of data required'.

SELECT single MCID
FROM DD23L
INTO @DATA(ld_mcid_name).


SELECT single MCONAME
FROM DD23L
INTO @DATA(ld_mco_name).

DATA(ld_prid) = '123 '.

DATA(ld_withtext) = some text here

"populate fields of struture and append to itab
append wa_dd24v_tab_a to it_dd24v_tab_a.

"populate fields of struture and append to itab
append wa_dd24v_tab_n to it_dd24v_tab_n.

"populate fields of struture and append to itab
append wa_dd21v_tab_a to it_dd21v_tab_a.

"populate fields of struture and append to itab
append wa_dd21v_tab_n to it_dd21v_tab_n.

"populate fields of struture and append to itab
append wa_dd28v_tab_a to it_dd28v_tab_a.

"populate fields of struture and append to itab
append wa_dd28v_tab_n to it_dd28v_tab_n. . CALL FUNCTION 'DD_MCID_GET' EXPORTING * get_state = ld_get_state * langu = ld_langu mcid_name = ld_mcid_name mco_name = ld_mco_name * prid = ld_prid * withtext = ld_withtext IMPORTING dd23v_wa_a = ld_dd23v_wa_a dd23v_wa_n = ld_dd23v_wa_n got_state = ld_got_state * TABLES * dd24v_tab_a = it_dd24v_tab_a * dd24v_tab_n = it_dd24v_tab_n * dd21v_tab_a = it_dd21v_tab_a * dd21v_tab_n = it_dd21v_tab_n * dd28v_tab_a = it_dd28v_tab_a * dd28v_tab_n = it_dd28v_tab_n EXCEPTIONS ACCESS_FAILURE = 1 . " DD_MCID_GET
IF SY-SUBRC EQ 0. "All OK ELSEIF SY-SUBRC EQ 1. "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_dd23v_wa_a  TYPE DD23V ,
ld_get_state  TYPE DCMCIDGET ,
it_dd24v_tab_a  TYPE STANDARD TABLE OF DD24V ,
wa_dd24v_tab_a  LIKE LINE OF it_dd24v_tab_a,
ld_dd23v_wa_n  TYPE DD23V ,
ld_langu  TYPE SY-LANGU ,
it_dd24v_tab_n  TYPE STANDARD TABLE OF DD24V ,
wa_dd24v_tab_n  LIKE LINE OF it_dd24v_tab_n,
ld_got_state  TYPE DCMCIDGET ,
ld_mcid_name  TYPE DD23L-MCID ,
it_dd21v_tab_a  TYPE STANDARD TABLE OF DD21V ,
wa_dd21v_tab_a  LIKE LINE OF it_dd21v_tab_a,
ld_mco_name  TYPE DD23L-MCONAME ,
it_dd21v_tab_n  TYPE STANDARD TABLE OF DD21V ,
wa_dd21v_tab_n  LIKE LINE OF it_dd21v_tab_n,
ld_prid  TYPE SY-TABIX ,
it_dd28v_tab_a  TYPE STANDARD TABLE OF DD28V ,
wa_dd28v_tab_a  LIKE LINE OF it_dd28v_tab_a,
ld_withtext  TYPE DDREFSTRUC-BOOL ,
it_dd28v_tab_n  TYPE STANDARD TABLE OF DD28V ,
wa_dd28v_tab_n  LIKE LINE OF it_dd28v_tab_n.

ld_get_state = '123 '.

"populate fields of struture and append to itab
append wa_dd24v_tab_a to it_dd24v_tab_a.
ld_langu = 'Check type of data required'.

"populate fields of struture and append to itab
append wa_dd24v_tab_n to it_dd24v_tab_n.

SELECT single MCID
FROM DD23L
INTO ld_mcid_name.


"populate fields of struture and append to itab
append wa_dd21v_tab_a to it_dd21v_tab_a.

SELECT single MCONAME
FROM DD23L
INTO ld_mco_name.


"populate fields of struture and append to itab
append wa_dd21v_tab_n to it_dd21v_tab_n.
ld_prid = '123 '.

"populate fields of struture and append to itab
append wa_dd28v_tab_a to it_dd28v_tab_a.

ld_withtext = some text here

"populate fields of struture and append to itab
append wa_dd28v_tab_n to it_dd28v_tab_n.

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 DD_MCID_GET or its description.