Start of Content Area

RENAME_TEXT   Locate the document in its SAP Library structure

In application programs, the complete name of a master record or document is known only directly before the COMMIT WORK. In the meantime, the system must use dummy names for the corresponding text modules. Before the COMMIT_TEXT, it must replace the dummy names with the final names, using the function module RENAME_TEXT. The text concerned receives the name specified in NEWNAME.

You can change only the name of one text module. OBJECT, ID, and LANGUAGE remain unchanged. Generic entries for ID and LANGUAGE are allowed.

Caution

The text module does not execute RENAME in 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 parameters

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.