Show TOC

RENAME_TEXTLocate this document in the navigation structure

Use

In application programs, the complete name of the master record or document is usually only fixed shortly before the COMMIT WORK. In the meantime a dummy name must be used to work with the related text modules. These dummy names must be replaced by the actual names before the COMMIT_TEXT. This is performed with the function module RENAME_TEXT. The texts concerned are given the name specified in NEWNAME.

Only the name of a text module can be changed. OBJECT, ID, and LANGUAGE remain the same. Generic entries for ID and language are valid.

Caution

The text module does not perform a RENAME on the database. It only renames texts in the text memory.

Function call:

CALL FUNCTION 'RENAME_TEXT'
        EXPORTING
                OBJECT  = ?...
                NAME    = ?...
                ID      = ?...
                LANGUAGE = ?...
                NEWNAME = ?...
        EXCEPTIONS
                NOT_FOUND =
            

Export Parameter

OBJECT

Enter the name of the text object to which the text is allocated.

Reference field: THEAD-TDOBJECT

NAME

Enter the name of the text module you want to rename.

Reference field: THEAD-TDNAME

ID

Enter the text ID of the text module you want to rename. You can enter a generic value.

Reference field: THEAD-TDID

LANGUAGE

Enter the language key of the text module. You can enter a generic value.

Reference field: THEAD-TDSPRAS

NEWNAME

NEWNAME determines the new text name. The system renames all texts in the text memory that match the selections specified in the parameters OBJECT, NAME, ID, and LANGUAGE.

Reference field: THEAD-TDNAME

Exceptions

NOT_FOUND

The system did not find the specified text module.