SPLIT_EQUITY SAP Function module - Split Amounts Based on Current Equity Group Share Table

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

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

Pattern for FM SPLIT_EQUITY - SPLIT EQUITY

CALL FUNCTION 'SPLIT_EQUITY' "Split Amounts Based on Current Equity Group Share Table
  EXPORTING
    i_local_amt =               " t8jvt02-hsl   Local Amount
    i_trans_amt =               " t8jvt02-tsl   Transaction Amount
*   i_local2_amt = 0            " t8jvt02-hsl2
*   i_local3_amt = 0            " t8jvt02-hsl3
  IMPORTING
    e_oper_alloc_error =        "               Operator Allocation Error (Y or N) {see notes}
  TABLES
    e_int_eq_share =            " t8jvt02       Equity Share Table - structure T8JVT02
  EXCEPTIONS
    INCOMPLETE = 1              "               Parameters Incomplete or Invalid
    .  "  SPLIT_EQUITY

ABAP code example for Function Module SPLIT_EQUITY

The ABAP code below is a full code listing to execute function module SPLIT_EQUITY 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_e_oper_alloc_error  
 
 TYPE STRING
,
it_e_int_eq_share  
 
 TYPE STANDARD TABLE OF T8JVT02,"TABLES PARAM
wa_e_int_eq_share
 
 LIKE LINE OF it_e_int_eq_share
.



DATA(ld_i_local_amt) = 20.50


DATA(ld_i_trans_amt) = 20.50


DATA(ld_i_local2_amt) = 20.50


DATA(ld_i_local3_amt) = 20.50
 

"populate fields of struture and append to itab
append wa_e_int_eq_share to it_e_int_eq_share.
.

CALL FUNCTION 'SPLIT_EQUITY'
  EXPORTING
    i_local_amt =                ld_i_local_amt
    i_trans_amt =                ld_i_trans_amt
*   i_local2_amt =               ld_i_local2_amt
*   i_local3_amt =               ld_i_local3_amt
  IMPORTING
    e_oper_alloc_error =         ld_e_oper_alloc_error
  TABLES
    e_int_eq_share =             it_e_int_eq_share
  EXCEPTIONS
    INCOMPLETE =                 1
    .  "  SPLIT_EQUITY

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_e_oper_alloc_error
 
 TYPE STRING ,
ld_i_local_amt
 
 TYPE T8JVT02-HSL ,
it_e_int_eq_share
 
 TYPE STANDARD TABLE OF T8JVT02 ,
wa_e_int_eq_share
 
 LIKE LINE OF it_e_int_eq_share,
ld_i_trans_amt
 
 TYPE T8JVT02-TSL ,
ld_i_local2_amt
 
 TYPE T8JVT02-HSL2 ,
ld_i_local3_amt
 
 TYPE T8JVT02-HSL3 .



ld_i_local_amt = 20.50 

"populate fields of struture and append to itab
append wa_e_int_eq_share to it_e_int_eq_share.

ld_i_trans_amt = 20.50

ld_i_local2_amt = 20.50

ld_i_local3_amt = 20.50