CTHE_VALUE_F4 SAP Function module - Possible entries for char. value (F4)

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

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

Pattern for FM CTHE_VALUE_F4 - CTHE VALUE F4

CALL FUNCTION 'CTHE_VALUE_F4' "Possible entries for char. value (F4)
* EXPORTING
*   i_atinn =                   " cabn-atinn    Internal Characteristic Number
*   i_atnam =                   " cabn-atnam    Characteristic Name
*   i_display_only = SPACE      " sy-batch      Display Only
*   i_only_allowed_values = SPACE  " sy-batch
*   i_show_description = SPACE  " sy-batch
*   i_key_date = SY-DATUM       " rmcls-key_date
  IMPORTING
    e_value =                   " cawn-atwrt    Characteristic Value
  EXCEPTIONS
    NO_SELECTION = 1            "               No Selection
    CHARACT_NOT_FOUND = 2       "               Characteristic does not exist
    NO_VALUES_FOUND = 3         "
    .  "  CTHE_VALUE_F4

ABAP code example for Function Module CTHE_VALUE_F4

The ABAP code below is a full code listing to execute function module CTHE_VALUE_F4 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_value  
 
 TYPE CAWN-ATWRT
.

 

SELECT single ATINN 
  FROM CABN 
  INTO @DATA(ld_i_atinn).

 

SELECT single ATNAM 
  FROM CABN 
  INTO @DATA(ld_i_atnam).


DATA(ld_i_display_only) = 'some text here'.

DATA(ld_i_only_allowed_values) = 'some text here'.

DATA(ld_i_show_description) = 'some text here'.


DATA(ld_i_key_date) = 20210129
.

CALL FUNCTION 'CTHE_VALUE_F4'
* EXPORTING
*   i_atinn =                    ld_i_atinn
*   i_atnam =                    ld_i_atnam
*   i_display_only =             ld_i_display_only
*   i_only_allowed_values =      ld_i_only_allowed_values
*   i_show_description =         ld_i_show_description
*   i_key_date =                 ld_i_key_date
  IMPORTING
    e_value =                    ld_e_value
  EXCEPTIONS
    NO_SELECTION =               1
    CHARACT_NOT_FOUND =          2
    NO_VALUES_FOUND =            3
    .  "  CTHE_VALUE_F4

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
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_value
 
 TYPE CAWN-ATWRT ,
ld_i_atinn
 
 TYPE CABN-ATINN ,
ld_i_atnam
 
 TYPE CABN-ATNAM ,
ld_i_display_only
 
 TYPE SY-BATCH ,
ld_i_only_allowed_values
 
 TYPE SY-BATCH ,
ld_i_show_description
 
 TYPE SY-BATCH ,
ld_i_key_date
 
 TYPE RMCLS-KEY_DATE .



SELECT single ATINN 
  FROM CABN 
  INTO ld_i_atinn.


SELECT single ATNAM 
  FROM CABN 
  INTO ld_i_atnam.

ld_i_display_only = 'some text here'.
ld_i_only_allowed_values = 'some text here'.
ld_i_show_description = 'some text here'.

ld_i_key_date = 20210129