RSTS_HIERARCHY_INFO SAP Function module - BRST Obtain hierarchy information for sets

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

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

Pattern for FM RSTS_HIERARCHY_INFO - RSTS HIERARCHY INFO

CALL FUNCTION 'RSTS_HIERARCHY_INFO' "BRST Obtain hierarchy information for sets
* EXPORTING
*   requester = SPACE           " rstsender     Requested by
*   i_sel = SPACE               " any           Selection rucksack (background)
*   only_one = SPACE            " flag          Flag: Only one hierarchy is expected
  TABLES
    i_rsthinfo =                " rsthinfo      Internal tables with all hierarchy information
  EXCEPTIONS
    NO_HIERARCHY = 1            "               No hierarchy found
    .  "  RSTS_HIERARCHY_INFO

ABAP code example for Function Module RSTS_HIERARCHY_INFO

The ABAP code below is a full code listing to execute function module RSTS_HIERARCHY_INFO 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:
it_i_rsthinfo  
 
 TYPE STANDARD TABLE OF RSTHINFO,"TABLES PARAM
wa_i_rsthinfo
 
 LIKE LINE OF it_i_rsthinfo
.


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

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

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

"populate fields of struture and append to itab
append wa_i_rsthinfo to it_i_rsthinfo.
.

CALL FUNCTION 'RSTS_HIERARCHY_INFO'
* EXPORTING
*   requester =                  ld_requester
*   i_sel =                      ld_i_sel
*   only_one =                   ld_only_one
  TABLES
    i_rsthinfo =                 it_i_rsthinfo
  EXCEPTIONS
    NO_HIERARCHY =               1
    .  "  RSTS_HIERARCHY_INFO

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "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_requester
 
 TYPE RSTSENDER ,
it_i_rsthinfo
 
 TYPE STANDARD TABLE OF RSTHINFO ,
wa_i_rsthinfo
 
 LIKE LINE OF it_i_rsthinfo,
ld_i_sel
 
 TYPE ANY ,
ld_only_one
 
 TYPE FLAG .


ld_requester = 'Check type of data required'. 

"populate fields of struture and append to itab
append wa_i_rsthinfo to it_i_rsthinfo.
ld_i_sel = 'Check type of data required'.
ld_only_one = 'Check type of data required'.