ADDRESS_GET_NATIO SAP Function module

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

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

Pattern for FM ADDRESS_GET_NATIO - ADDRESS GET NATIO

CALL FUNCTION 'ADDRESS_GET_NATIO' "
* EXPORTING
*   kind_of_action = 'D'        " sy-input      Type of action /D'isplay/C'eck without D
*   langu_param = SY-LANGU      " sy-langu      Application language
*   natio_param = SPACE         " sadr-natio    National indicator
  IMPORTING
    ex_natio =                  " sadr-natio    National indicator
    ex_txt12 =                  " tsavt-txt12   Description 12Char
    ex_txt60 =                  " tsavt-txt60   Description 60Char
    rtcode =                    " sy-subrc
    rtcode =                    " sy-subrc      Return code /4= error /3= chosen /
  EXCEPTIONS
    NATIO_NOT_FOUND = 1         "               During check: indicator not found
    NO_DATA_IN_TSAVT = 2        "
    .  "  ADDRESS_GET_NATIO

ABAP code example for Function Module ADDRESS_GET_NATIO

The ABAP code below is a full code listing to execute function module ADDRESS_GET_NATIO 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_ex_natio  
 
 TYPE SADR-NATIO
,
ld_ex_txt12  
 
 TYPE TSAVT-TXT12
,
ld_ex_txt60  
 
 TYPE TSAVT-TXT60
,
ld_rtcode  
 
 TYPE SY-SUBRC
,
ld_rtcode  
 
 TYPE SY-SUBRC
.


DATA(ld_kind_of_action) = 'some text here'.

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

SELECT single NATIO 
  FROM SADR 
  INTO @DATA(ld_natio_param).

.

CALL FUNCTION 'ADDRESS_GET_NATIO'
* EXPORTING
*   kind_of_action =             ld_kind_of_action
*   langu_param =                ld_langu_param
*   natio_param =                ld_natio_param
  IMPORTING
    ex_natio =                   ld_ex_natio
    ex_txt12 =                   ld_ex_txt12
    ex_txt60 =                   ld_ex_txt60
    rtcode =                     ld_rtcode
    rtcode =                     ld_rtcode
  EXCEPTIONS
    NATIO_NOT_FOUND =            1
    NO_DATA_IN_TSAVT =           2
    .  "  ADDRESS_GET_NATIO

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_ex_natio
 
 TYPE SADR-NATIO ,
ld_kind_of_action
 
 TYPE SY-INPUT ,
ld_ex_txt12
 
 TYPE TSAVT-TXT12 ,
ld_langu_param
 
 TYPE SY-LANGU ,
ld_ex_txt60
 
 TYPE TSAVT-TXT60 ,
ld_natio_param
 
 TYPE SADR-NATIO ,
ld_rtcode
 
 TYPE SY-SUBRC ,
ld_rtcode
 
 TYPE SY-SUBRC .


ld_kind_of_action = 'some text here'.
ld_langu_param = 'Check type of data required'.

SELECT single NATIO 
  FROM SADR 
  INTO ld_natio_param.