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.
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. |