BDL_SERVDEF_ADD_TOP_NODE SAP Function module - Add service at the top level just below the service name

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

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

Pattern for FM BDL_SERVDEF_ADD_TOP_NODE - BDL SERVDEF ADD TOP NODE

CALL FUNCTION 'BDL_SERVDEF_ADD_TOP_NODE' "Add service at the top level just below the service name
  EXPORTING
    p_contract =                " bdlsergrps-contract  Agreement type
    p_descr =                   " bdlsergrps-descr  Session subtype
    p_groupname =               " bdlgroups-groupname  Group name
    p_sequence =                " bdlgroups-sequence  Sequence number
    p_context =                 " bdlgroups-context  Context
    p_docu =                    " bdlgroups-docu  Character string containing documentation
    p_status =                  " bdlgroups-status  Status of object
  IMPORTING
    new_groupid =               " bdlgroups-groupid  Group ID
  EXCEPTIONS
    SERVICE_NOT_FOUND = 1       "
    MODIFY_BDLSERGRPS_FAILED = 2  "
    MODIFY_BDLGROUPS_FAILED = 3  "
    NO_MORE_GROUP_IDS = 4       "
    .  "  BDL_SERVDEF_ADD_TOP_NODE

ABAP code example for Function Module BDL_SERVDEF_ADD_TOP_NODE

The ABAP code below is a full code listing to execute function module BDL_SERVDEF_ADD_TOP_NODE 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_new_groupid  
 
 TYPE BDLGROUPS-GROUPID
.

 

SELECT single CONTRACT 
  FROM BDLSERGRPS 
  INTO @DATA(ld_p_contract).

 

SELECT single DESCR 
  FROM BDLSERGRPS 
  INTO @DATA(ld_p_descr).

 

SELECT single GROUPNAME 
  FROM BDLGROUPS 
  INTO @DATA(ld_p_groupname).

 

SELECT single SEQUENCE 
  FROM BDLGROUPS 
  INTO @DATA(ld_p_sequence).

 

SELECT single CONTEXT 
  FROM BDLGROUPS 
  INTO @DATA(ld_p_context).

 

SELECT single DOCU 
  FROM BDLGROUPS 
  INTO @DATA(ld_p_docu).

 

SELECT single STATUS 
  FROM BDLGROUPS 
  INTO @DATA(ld_p_status).

.

CALL FUNCTION 'BDL_SERVDEF_ADD_TOP_NODE'
  EXPORTING
    p_contract =                 ld_p_contract
    p_descr =                    ld_p_descr
    p_groupname =                ld_p_groupname
    p_sequence =                 ld_p_sequence
    p_context =                  ld_p_context
    p_docu =                     ld_p_docu
    p_status =                   ld_p_status
  IMPORTING
    new_groupid =                ld_new_groupid
  EXCEPTIONS
    SERVICE_NOT_FOUND =          1
    MODIFY_BDLSERGRPS_FAILED =    2
    MODIFY_BDLGROUPS_FAILED =    3
    NO_MORE_GROUP_IDS =          4
    .  "  BDL_SERVDEF_ADD_TOP_NODE

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
ELSEIF SY-SUBRC EQ 4. "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_new_groupid
 
 TYPE BDLGROUPS-GROUPID ,
ld_p_contract
 
 TYPE BDLSERGRPS-CONTRACT ,
ld_p_descr
 
 TYPE BDLSERGRPS-DESCR ,
ld_p_groupname
 
 TYPE BDLGROUPS-GROUPNAME ,
ld_p_sequence
 
 TYPE BDLGROUPS-SEQUENCE ,
ld_p_context
 
 TYPE BDLGROUPS-CONTEXT ,
ld_p_docu
 
 TYPE BDLGROUPS-DOCU ,
ld_p_status
 
 TYPE BDLGROUPS-STATUS .



SELECT single CONTRACT 
  FROM BDLSERGRPS 
  INTO ld_p_contract.


SELECT single DESCR 
  FROM BDLSERGRPS 
  INTO ld_p_descr.


SELECT single GROUPNAME 
  FROM BDLGROUPS 
  INTO ld_p_groupname.


SELECT single SEQUENCE 
  FROM BDLGROUPS 
  INTO ld_p_sequence.


SELECT single CONTEXT 
  FROM BDLGROUPS 
  INTO ld_p_context.


SELECT single DOCU 
  FROM BDLGROUPS 
  INTO ld_p_docu.


SELECT single STATUS 
  FROM BDLGROUPS 
  INTO ld_p_status.