Show TOC

TEXT_SYMBOL_SETVALUELocate this document in the navigation structure

Use

A SAPscript symbol can be assigned a value with the function TEXT_SYMBOL_SETVALUE. You can only change the values of text symbols. System symbols, standard symbols, and program symbols cannot be assigned new values.

The system keeps the new value until you initialize the symbol administration tables in SAPscript. To do this, you can use, for example, OPEN_FORM or TEXT_SYMBOL_REPLACE with the parameter INIT = ´X´.

Function call: 

CALL FUNCTION 'TEXT_SYMBOL_SETVALUE'
        EXPORTING
                NAME            = ?...
                VALUE           = ?...
                VALUE_LENGTH    = 0
                REPLACE_SYMBOLS = ' '

Export parameters:

NAME

The parameter contains the name of the symbol to which you want to assign a new value.

Only the symbol name can be specified, without the text supplements or the possible formatting options. You can include the escape symbols &.

VALUE

Define the value of the symbol here. The length of the value is limited. A maximum of 80 characters of the character string which is transferred here are passed as the symbol value.

VALUE_LENGTH

If this parameter is not specified or if it has the value 0, the length of the symbol value is determined automatically. All characters up to the last blank are included in the value.

If you want to include trailing blanks into the assignment, specify the desired length of the symbol value here.

Reference field: SY-TABIX

Default value: 0

REPLACE_SYMBOLS

The value 'X' in this parameter means that symbols contained in the field VALUE are replaced immediately with their current values; the assigned value no longer contains SAPscript symbols.

If the parameter is empty, the system includes the contents of the VALUE field without change. Symbols in it are not replaced by their current value until the symbol specified in the parameter NAME is called in the text.

Default value: ' '