CHECK_FORMULA SAP Function module - Check syntax of a formula

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

Associated Function Group: CALC
Released Date: 25.03.1997
Processing type: Normal fucntion module

Pattern for FM CHECK_FORMULA - CHECK FORMULA

CALL FUNCTION 'CHECK_FORMULA' "Check syntax of a formula
  EXPORTING
    formula =                   "               Formula to be checked
*   program = SPACE             "               Program for value assignment to a variable
*   routine = SPACE             "               Routine for value assignment to a variable
*   unit_of_measure = SPACE     "               Unit of measurement for calculated value
  IMPORTING
    funcname =                  "               Function name of the called routine
    message =                   "               Error Message
    pos =                       "               Position of first error
    subrc =                     "               Error status
  EXCEPTIONS
    ERROR_IN_FORMULA = 1        "               Error in formula (with MESSAGE E... RAISING)
    MISSING_PARAMETER = 2       "               Program or Routines Missing for Variables
    .  "  CHECK_FORMULA

ABAP code example for Function Module CHECK_FORMULA

The ABAP code below is a full code listing to execute function module CHECK_FORMULA 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_funcname  
 
 TYPE STRING
,
ld_message  
 
 TYPE STRING
,
ld_pos  
 
 TYPE STRING
,
ld_subrc  
 
 TYPE STRING
.


DATA(ld_formula) = 'some text here'.

DATA(ld_program) = 'some text here'.

DATA(ld_routine) = 'some text here'.

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

CALL FUNCTION 'CHECK_FORMULA'
  EXPORTING
    formula =                    ld_formula
*   program =                    ld_program
*   routine =                    ld_routine
*   unit_of_measure =            ld_unit_of_measure
  IMPORTING
    funcname =                   ld_funcname
    message =                    ld_message
    pos =                        ld_pos
    subrc =                      ld_subrc
  EXCEPTIONS
    ERROR_IN_FORMULA =           1
    MISSING_PARAMETER =          2
    .  "  CHECK_FORMULA

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_funcname
 
 TYPE STRING ,
ld_formula
 
 TYPE STRING ,
ld_message
 
 TYPE STRING ,
ld_program
 
 TYPE STRING ,
ld_pos
 
 TYPE STRING ,
ld_routine
 
 TYPE STRING ,
ld_subrc
 
 TYPE STRING ,
ld_unit_of_measure
 
 TYPE STRING .


ld_formula = 'some text here'.
ld_program = 'some text here'.
ld_routine = 'some text here'.
ld_unit_of_measure = 'some text here'.

SAP Documentation for FM CHECK_FORMULA