DB_DROP_INDEX SAP Function module

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

Associated Function Group: SDB2
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM DB_DROP_INDEX - DB DROP INDEX

CALL FUNCTION 'DB_DROP_INDEX' "
  EXPORTING
    dbindex =                   " dd12l-dbindex
    dbindex =                   " dd12l-dbindex  Name of the index on the DB
*   dbsys = SY-DBSYS            " sy-dbsys
*   dbsys = SY-DBSYS            " sy-dbsys      DBS for which program is generated
*   no_exec = SPACE             "
*   no_exec = SPACE             "               X: do not execute generated program
*   prid = 0                    " sy-tabix
*   progname = SPACE            " trdir-name    Name of the generated program
    tabname =                   " dd02l-tabname
    tabname =                   " dd02l-tabname  Name of the table to be deleted
*   db_check_flag = 'X'         "
  IMPORTING
    genprog =                   " trdir-name
    genprog =                   " trdir-name    actual name of the generated program
    subrc =                     " sy-subrc
    subrc =                     " sy-subrc      0: deleted; 4: index does not exist
  EXCEPTIONS
    INDEX_NOT_DROPPED = 1       "               Error when deleting the index
    PROGRAM_NOT_GENERATED = 2   "               Program could not be generated
    PROGRAM_NOT_WRITTEN = 3     "               Program could not be written
    .  "  DB_DROP_INDEX

ABAP code example for Function Module DB_DROP_INDEX

The ABAP code below is a full code listing to execute function module DB_DROP_INDEX 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_genprog  
 
 TYPE TRDIR-NAME
,
ld_genprog  
 
 TYPE TRDIR-NAME
,
ld_subrc  
 
 TYPE SY-SUBRC
,
ld_subrc  
 
 TYPE SY-SUBRC
.

 

SELECT single DBINDEX 
  FROM DD12L 
  INTO @DATA(ld_dbindex).

 

SELECT single DBINDEX 
  FROM DD12L 
  INTO @DATA(ld_dbindex).


DATA(ld_dbsys) = 'some text here'.

DATA(ld_dbsys) = 'some text here'.

DATA(ld_no_exec) = 'some text here'.

DATA(ld_no_exec) = 'some text here'.

DATA(ld_prid) = '123 '.
 

SELECT single NAME 
  FROM TRDIR 
  INTO @DATA(ld_progname).

 

SELECT single TABNAME 
  FROM DD02L 
  INTO @DATA(ld_tabname).

 

SELECT single TABNAME 
  FROM DD02L 
  INTO @DATA(ld_tabname).


DATA(ld_db_check_flag) = 'some text here'.
.

CALL FUNCTION 'DB_DROP_INDEX'
  EXPORTING
    dbindex =                    ld_dbindex
    dbindex =                    ld_dbindex
*   dbsys =                      ld_dbsys
*   dbsys =                      ld_dbsys
*   no_exec =                    ld_no_exec
*   no_exec =                    ld_no_exec
*   prid =                       ld_prid
*   progname =                   ld_progname
    tabname =                    ld_tabname
    tabname =                    ld_tabname
*   db_check_flag =              ld_db_check_flag
  IMPORTING
    genprog =                    ld_genprog
    genprog =                    ld_genprog
    subrc =                      ld_subrc
    subrc =                      ld_subrc
  EXCEPTIONS
    INDEX_NOT_DROPPED =          1
    PROGRAM_NOT_GENERATED =      2
    PROGRAM_NOT_WRITTEN =        3
    .  "  DB_DROP_INDEX

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
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_genprog
 
 TYPE TRDIR-NAME ,
ld_genprog
 
 TYPE TRDIR-NAME ,
ld_dbindex
 
 TYPE DD12L-DBINDEX ,
ld_dbindex
 
 TYPE DD12L-DBINDEX ,
ld_subrc
 
 TYPE SY-SUBRC ,
ld_subrc
 
 TYPE SY-SUBRC ,
ld_dbsys
 
 TYPE SY-DBSYS ,
ld_dbsys
 
 TYPE SY-DBSYS ,
ld_no_exec
 
 TYPE STRING ,
ld_no_exec
 
 TYPE STRING ,
ld_prid
 
 TYPE SY-TABIX ,
ld_progname
 
 TYPE TRDIR-NAME ,
ld_tabname
 
 TYPE DD02L-TABNAME ,
ld_tabname
 
 TYPE DD02L-TABNAME ,
ld_db_check_flag
 
 TYPE STRING .



SELECT single DBINDEX 
  FROM DD12L 
  INTO ld_dbindex.


SELECT single DBINDEX 
  FROM DD12L 
  INTO ld_dbindex.

ld_dbsys = 'some text here'.
ld_dbsys = 'some text here'.
ld_no_exec = 'some text here'.
ld_no_exec = 'some text here'.
ld_prid = '123 '.

SELECT single NAME 
  FROM TRDIR 
  INTO ld_progname.


SELECT single TABNAME 
  FROM DD02L 
  INTO ld_tabname.


SELECT single TABNAME 
  FROM DD02L 
  INTO ld_tabname.

ld_db_check_flag = 'some text here'.