SAP Function Modules

comments icon Comments

ENQUEUE_READ SAP Function module - Read lock entries from lock table







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

Associated Function Group: SENT
Released Date: 10.11.1994
Processing type: Remote-Enabled
remote enabled module settings


Pattern for FM ENQUEUE_READ - ENQUEUE READ 





CALL FUNCTION 'ENQUEUE_READ' "Read lock entries from lock table
* EXPORTING
*   gclient = SY-MANDT          " seqg3-gclient  Client
*   gname = SPACE               " seqg3-gname   Granularity name (-> table name)
*   garg = SPACE                " seqg3-garg    Granularity value(->values of key fields)
*   guname = SY-UNAME           " seqg3-guname  User name
*   local = SPACE               " sy-ctype      Single-Character Flag
*   fast = SPACE                " sy-ctype      Redundant table fields are not fully filled
*   gargnowc = SPACE            " sy-ctype      All characters in GARG are literals
  IMPORTING
    number =                    " sy-tabix      Number of chosen lock entries
    subrc =                     " sy-subrc      Error code of the enqueue call
  TABLES
    enq =                       " seqg3         List of the chosen lock entries
  EXCEPTIONS
    COMMUNICATION_FAILURE = 1   "               See RFC documentation
    SYSTEM_FAILURE = 2          "               See RFC documentation
    .  "  ENQUEUE_READ

ABAP code example for Function Module ENQUEUE_READ





The ABAP code below is a full code listing to execute function module ENQUEUE_READ 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_number    TYPE SY-TABIX
,
ld_subrc    TYPE SY-SUBRC
,
it_enq    TYPE STANDARD TABLE OF SEQG3,"TABLES PARAM
wa_enq  LIKE LINE OF it_enq
.





DATA(ld_gclient) = some text here


DATA(ld_gname) = some text here


DATA(ld_garg) = some text here


DATA(ld_guname) = some text here

DATA(ld_local) = 'some text here'.

DATA(ld_fast) = 'some text here'.

DATA(ld_gargnowc) = 'some text here'.
 

"populate fields of struture and append to itab
append wa_enq to it_enq.
.

CALL FUNCTION 'ENQUEUE_READ'
* EXPORTING
*   gclient =                    ld_gclient
*   gname =                      ld_gname
*   garg =                       ld_garg
*   guname =                     ld_guname
*   local =                      ld_local
*   fast =                       ld_fast
*   gargnowc =                   ld_gargnowc
  IMPORTING
    number =                     ld_number
    subrc =                      ld_subrc
  TABLES
    enq =                        it_enq
  EXCEPTIONS
    COMMUNICATION_FAILURE =      1
    SYSTEM_FAILURE =             2
    .  "  ENQUEUE_READ

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_number  TYPE SY-TABIX ,
ld_gclient  TYPE SEQG3-GCLIENT ,
it_enq  TYPE STANDARD TABLE OF SEQG3 ,
wa_enq  LIKE LINE OF it_enq,
ld_subrc  TYPE SY-SUBRC ,
ld_gname  TYPE SEQG3-GNAME ,
ld_garg  TYPE SEQG3-GARG ,
ld_guname  TYPE SEQG3-GUNAME ,
ld_local  TYPE SY-CTYPE ,
ld_fast  TYPE SY-CTYPE ,
ld_gargnowc  TYPE SY-CTYPE .





ld_gclient = some text here 

"populate fields of struture and append to itab
append wa_enq to it_enq.

ld_gname = some text here

ld_garg = some text here

ld_guname = some text here
ld_local = 'some text here'.
ld_fast = 'some text here'.
ld_gargnowc = '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 ENQUEUE_READ or its description.


   
 

ENQUEUE_READ - Read lock entries from lock table
ENQUEUE_RCPL_PP_MIG - Request lock for object RCPL_PP_MIG
ENQUEUE_PTT510_8A_8B - Request lock for object PTT510_8A_8B
ENQUEUE_N1MEDS_USRPREF - Request lock for object N1MEDS_USRPREF
ENQUEUE_N1MEDS_USRFAV - Request lock for object N1MEDS_USRFAV
ENQUEUE_MWAUKOS - Request lock for object MWAUKOS