SAP Function Modules

comments icon Comments

MC_PREPARE_MCID SAP Function module - Read a matchcode ID about the data interface







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

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


Pattern for FM MC_PREPARE_MCID - MC PREPARE MCID 





CALL FUNCTION 'MC_PREPARE_MCID' "Read a matchcode ID about the data interface
  EXPORTING
*   language = SY-LANGU         " sy-langu      Language
    mcid =                      " dd23l-mcid    Matchcode ID
    mconame =                   " dd20l-mconame  Name of the matchcode object
*   status = 'A'                " mcmaco-status  Status in which the matchcode object can be read
*   prid = 0                    " sy-tabix      Log ID
  IMPORTING
    dd23v_exp =                 " dd23v         Header of the matchcode object
    rc =                        " sy-subrc      Output of error structure (severity, number)
  TABLES
    dd21v_tab =                 " dd21v         Structure of the matchcode object
    dd24v_tab =                 " dd24v         Fields of the matchcode object with data types
    dd28v_tab =                 " dd28v
  EXCEPTIONS
    ID_NOT_EXISTS = 1           "               Matchcode ID does not exist
    ILLEGAL_STATE = 2           "               Incorrect status
    .  "  MC_PREPARE_MCID

ABAP code example for Function Module MC_PREPARE_MCID





The ABAP code below is a full code listing to execute function module MC_PREPARE_MCID 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_exp    TYPE DD23V
,
ld_rc    TYPE SY-SUBRC
,
it_dd21v_tab    TYPE STANDARD TABLE OF DD21V,"TABLES PARAM
wa_dd21v_tab  LIKE LINE OF it_dd21v_tab
,
it_dd24v_tab    TYPE STANDARD TABLE OF DD24V,"TABLES PARAM
wa_dd24v_tab  LIKE LINE OF it_dd24v_tab
,
it_dd28v_tab    TYPE STANDARD TABLE OF DD28V,"TABLES PARAM
wa_dd28v_tab  LIKE LINE OF it_dd28v_tab
.




DATA(ld_language) = 'Check type of data required'.
 

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

 

SELECT single MCONAME 
  FROM DD20L 
  INTO @DATA(ld_mconame).



DATA(ld_status) = some text here

DATA(ld_prid) = '123 '.
 

"populate fields of struture and append to itab
append wa_dd21v_tab to it_dd21v_tab.
 

"populate fields of struture and append to itab
append wa_dd24v_tab to it_dd24v_tab.
 

"populate fields of struture and append to itab
append wa_dd28v_tab to it_dd28v_tab.
.

CALL FUNCTION 'MC_PREPARE_MCID'
  EXPORTING
*   language =                   ld_language
    mcid =                       ld_mcid
    mconame =                    ld_mconame
*   status =                     ld_status
*   prid =                       ld_prid
  IMPORTING
    dd23v_exp =                  ld_dd23v_exp
    rc =                         ld_rc
  TABLES
    dd21v_tab =                  it_dd21v_tab
    dd24v_tab =                  it_dd24v_tab
    dd28v_tab =                  it_dd28v_tab
  EXCEPTIONS
    ID_NOT_EXISTS =              1
    ILLEGAL_STATE =              2
    .  "  MC_PREPARE_MCID

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
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_exp  TYPE DD23V ,
ld_language  TYPE SY-LANGU ,
it_dd21v_tab  TYPE STANDARD TABLE OF DD21V ,
wa_dd21v_tab  LIKE LINE OF it_dd21v_tab,
ld_rc  TYPE SY-SUBRC ,
ld_mcid  TYPE DD23L-MCID ,
it_dd24v_tab  TYPE STANDARD TABLE OF DD24V ,
wa_dd24v_tab  LIKE LINE OF it_dd24v_tab,
ld_mconame  TYPE DD20L-MCONAME ,
it_dd28v_tab  TYPE STANDARD TABLE OF DD28V ,
wa_dd28v_tab  LIKE LINE OF it_dd28v_tab,
ld_status  TYPE MCMACO-STATUS ,
ld_prid  TYPE SY-TABIX .




ld_language = 'Check type of data required'. 

"populate fields of struture and append to itab
append wa_dd21v_tab to it_dd21v_tab.

SELECT single MCID 
  FROM DD23L 
  INTO ld_mcid.
 

"populate fields of struture and append to itab
append wa_dd24v_tab to it_dd24v_tab.

SELECT single MCONAME 
  FROM DD20L 
  INTO ld_mconame.
 

"populate fields of struture and append to itab
append wa_dd28v_tab to it_dd28v_tab.

ld_status = some text here
ld_prid = '123 '.

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


   
 

MC_PREPARE_MCID - Read a matchcode ID about the data interface
MC_PORTFOLIO_PERFORM - 
MC_POPUP_TO_SELECT_FIELDS - 
MC_POPUP_TO_MARK_VALUES - 
MC_POPUP_TO_MARK_FIELDS - 
MC_POPUP_SELECT_VERSION_SAVE -