SAP Function Modules

ENQUEUE_EMYMP1 SAP Function module - Request lock for object EMYMP1







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

Associated Function Group: DWBEN/SAPLMEN0000
Released Date: Not Released
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM ENQUEUE_EMYMP1 - ENQUEUE EMYMP1





CALL FUNCTION 'ENQUEUE_EMYMP1' "Request lock for object EMYMP1
* EXPORTING
*   mode_mymp1 = 'E'            " enqmode       Lock mode for table MYMP1
*   mandt = SY-MANDT            " mymp1-mandt   01th enqueue argument
*   mykey =                     " mymp1-mykey   02th enqueue argument
*   matnr =                     " mymp1-matnr   03th enqueue argument
*   ebeln =                     " mymp1-ebeln   04th enqueue argument
*   ebelp =                     " mymp1-ebelp   05th enqueue argument
*   mblnr =                     " mymp1-mblnr   06th enqueue argument
*   mjahr =                     " mymp1-mjahr   07th enqueue argument
*   mblpo =                     " mymp1-mblpo   08th enqueue argument
*   x_mykey = SPACE             "               Fill argument 02 with initial value?
*   x_matnr = SPACE             "               Fill argument 03 with initial value?
*   x_ebeln = SPACE             "               Fill argument 04 with initial value?
*   x_ebelp = SPACE             "               Fill argument 05 with initial value?
*   x_mblnr = SPACE             "               Fill argument 06 with initial value?
*   x_mjahr = SPACE             "               Fill argument 07 with initial value?
*   x_mblpo = SPACE             "               Fill argument 08 with initial value?
*   _scope = '2'                "
*   _wait = SPACE               "
*   _collect = ' '              " ddenqcoll     Initially only collect lock
  EXCEPTIONS
    FOREIGN_LOCK = 1            "               Object already locked
    SYSTEM_FAILURE = 2          "               Internal error from enqueue server
    .  "  ENQUEUE_EMYMP1

ABAP code example for Function Module ENQUEUE_EMYMP1





The ABAP code below is a full code listing to execute function module ENQUEUE_EMYMP1 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_mode_mymp1) = 'Check type of data required'.

SELECT single MANDT
FROM MYMP1
INTO @DATA(ld_mandt).


SELECT single MYKEY
FROM MYMP1
INTO @DATA(ld_mykey).


SELECT single MATNR
FROM MYMP1
INTO @DATA(ld_matnr).


SELECT single EBELN
FROM MYMP1
INTO @DATA(ld_ebeln).


SELECT single EBELP
FROM MYMP1
INTO @DATA(ld_ebelp).


SELECT single MBLNR
FROM MYMP1
INTO @DATA(ld_mblnr).


SELECT single MJAHR
FROM MYMP1
INTO @DATA(ld_mjahr).


SELECT single MBLPO
FROM MYMP1
INTO @DATA(ld_mblpo).

DATA(ld_x_mykey) = 'some text here'.
DATA(ld_x_matnr) = 'some text here'.
DATA(ld_x_ebeln) = 'some text here'.
DATA(ld_x_ebelp) = 'some text here'.
DATA(ld_x_mblnr) = 'some text here'.
DATA(ld_x_mjahr) = 'some text here'.
DATA(ld_x_mblpo) = 'some text here'.
DATA(ld__scope) = 'some text here'.
DATA(ld__wait) = 'some text here'.
DATA(ld__collect) = 'Check type of data required'. . CALL FUNCTION 'ENQUEUE_EMYMP1' * EXPORTING * mode_mymp1 = ld_mode_mymp1 * mandt = ld_mandt * mykey = ld_mykey * matnr = ld_matnr * ebeln = ld_ebeln * ebelp = ld_ebelp * mblnr = ld_mblnr * mjahr = ld_mjahr * mblpo = ld_mblpo * x_mykey = ld_x_mykey * x_matnr = ld_x_matnr * x_ebeln = ld_x_ebeln * x_ebelp = ld_x_ebelp * x_mblnr = ld_x_mblnr * x_mjahr = ld_x_mjahr * x_mblpo = ld_x_mblpo * _scope = ld__scope * _wait = ld__wait * _collect = ld__collect EXCEPTIONS FOREIGN_LOCK = 1 SYSTEM_FAILURE = 2 . " ENQUEUE_EMYMP1
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_mode_mymp1  TYPE ENQMODE ,
ld_mandt  TYPE MYMP1-MANDT ,
ld_mykey  TYPE MYMP1-MYKEY ,
ld_matnr  TYPE MYMP1-MATNR ,
ld_ebeln  TYPE MYMP1-EBELN ,
ld_ebelp  TYPE MYMP1-EBELP ,
ld_mblnr  TYPE MYMP1-MBLNR ,
ld_mjahr  TYPE MYMP1-MJAHR ,
ld_mblpo  TYPE MYMP1-MBLPO ,
ld_x_mykey  TYPE STRING ,
ld_x_matnr  TYPE STRING ,
ld_x_ebeln  TYPE STRING ,
ld_x_ebelp  TYPE STRING ,
ld_x_mblnr  TYPE STRING ,
ld_x_mjahr  TYPE STRING ,
ld_x_mblpo  TYPE STRING ,
ld__scope  TYPE STRING ,
ld__wait  TYPE STRING ,
ld__collect  TYPE DDENQCOLL .

ld_mode_mymp1 = 'Check type of data required'.

SELECT single MANDT
FROM MYMP1
INTO ld_mandt.


SELECT single MYKEY
FROM MYMP1
INTO ld_mykey.


SELECT single MATNR
FROM MYMP1
INTO ld_matnr.


SELECT single EBELN
FROM MYMP1
INTO ld_ebeln.


SELECT single EBELP
FROM MYMP1
INTO ld_ebelp.


SELECT single MBLNR
FROM MYMP1
INTO ld_mblnr.


SELECT single MJAHR
FROM MYMP1
INTO ld_mjahr.


SELECT single MBLPO
FROM MYMP1
INTO ld_mblpo.

ld_x_mykey = 'some text here'.
ld_x_matnr = 'some text here'.
ld_x_ebeln = 'some text here'.
ld_x_ebelp = 'some text here'.
ld_x_mblnr = 'some text here'.
ld_x_mjahr = 'some text here'.
ld_x_mblpo = 'some text here'.
ld__scope = 'some text here'.
ld__wait = 'some text here'.
ld__collect = 'Check type of data required'.

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