COMMIT_TEXT

Use

All text modules which have saving in the update task defined via their object description are first held in the text memory. When the function 'Post' is called up in the application, the text modules must also be placed in the log file.

The function module COMMIT_TEXT generates a CALL FUNCTION ... IN UPDATE TASK for every text module entered in the text memory corresponding to the action to be executed (Delete, Create, Change). IN UPDATE TASK

Note

No COMMIT WORK is created. This can be initiated from the calling application program.

If you do not specify OBJECT, NAME, ID, and LANGUAGE, the system transfers all texts from the text memory. To limit the function to certain texts, enter values (fully or generically) in the above fields. In this case, all texts are selected that have the same characters in these fields up to the first occurrence of '*'.

The system then selects all texts that match the selections in the fields up to the first ' * '. If you want to keep updated texts in the text memory, call the function module with the parameter KEEP = 'X'. The system then keeps the texts in the text memory and flags them as updated. When calling COMMIT_TEXT again, the system ignores these texts. If you change such a text again during the transaction (for example, using SAVE_TEXT or DELETE_TEXT), the system deletes the flag. However, you need another COMMIT_TEXT to update the text.

Function call:

CALL FUNCTION 'COMMIT_TEXT'
EXPORTING OBJECT = '*'
NAME = '*'
ID = '*'
LANGUAGE = '*'
SAVEMODE_DIRECT = SPACE
KEEP = SPACE
IMPORTING COMMIT_COUNT =

Export parameters:

OBJECT	Enter the name of a text object. The system then transfers only texts with this text object to the log file. You can enter a generic value. If you omit this parameter, the system uses texts of all objects. Reference field: THEAD-TDOBJECT Default value: '*'
NAME	Enter the name of the text modules you want to update. You can enter a generic value. If you omit the parameter, the system uses all texts that match any other selections. Reference field: THEAD-TDNAME Default value: '*'
ID	Enter the text ID of the text module. You can enter a generic value. If you omit this parameter, the system uses all IDs. Reference field: THEAD-TDID Default value: '*'
LANGUAGE	Enter the language key of the text module. You can enter a generic value. If you omit this parameter, the system uses all languages. Reference field: THEAD-TDSPRAS Default value: '*'
SAVEMODE_DIRECT	You determine the storage mode of a text module (direct, in update task) via the text object in table TTXOB. In certain cases it makes sense to save the text immediately (for example, in batch programs) instead of in the update task. Possible values: ' ' Save mode according to text object 'X' Save text module immediately Default value: SPACE If you transfer this parameter with the value 'X', the affected texts are immediately written to the text file. No entries are written to the log file. A COMMIT WORK is not necessary for text modules.
KEEP	Use the parameter KEEP to indicate whether to keep updated texts in the text memory. It is therefore possible to access these text in the running transaction although a COMMIT WORK was not executed. If a COMMIT_TEXT is called again in the transaction, the texts held with KEEP are no longer updated, unless they were changed by calling function modules such as SAVE_TEXT or DELETE_TEXT. Default value: SPACE

Import parameter:

COMMIT_COUNT

The parameter holds the number of text modules transferred to the update program.

Reference field: SY-INDEX