COMMIT_TEXT

Alle Textbausteine, über deren Objektbezeichnung eine verbuchungsseitige Sicherung definiert ist, werden zunächst im Textmemory gehalten. Wird das zugehörige Anwendungsobjekt verbucht, müssen auch die Textbausteine in die Protokolldatei gestellt werden.

Der Funktionsbaustein COMMIT_TEXT generiert für die im Textmemory eingetragenen Textbausteine entsprechend der durchzuführenden Aktion (Löschen, Hinzufügen, Ändern) einen CALL FUNCTION... IN UPDATE TASK.

Hinweis Hinweis

Es wird kein COMMIT WORK erzeugt. Dieser ist vom rufenden Anwendungsprogramm zu veranlassen.

Ende des Hinweises.

Werden keine Angaben zu OBJECT, NAME, ID und LANGUAGE gemacht, werden alle Im Textmemory enthaltenen Texte übernommen. Sie können Funktion jedoch auf bestimmte Texte einschränken. In diesen Feldern sind auch generische Angaben erlaubt. Dabei werden alle Texte selektiert, die bei diesen Feldern in allen Zeichen bis zum ersten Zeichen '*' übereinstimmen.

Die auf die Protokolldatei gestellten Texte werden standardmäßig aus dem Textmemory gelöscht. Wenn Sie dies nicht wünschen, Rufen Sie den Funktionsbaustein mit dem Parameter KEEP = 'X' auf. Die Texte werden dann weiterhin im Textmemory gehalten, aber mit einem Kennzeichen versehen, daß sie schon gelöscht wurden. Bei einem erneuten Aufruf von COMMIT_TEXT werden die so gekennzeichneten Texte ignoriert. Das Kennzeichen wird zurückgenommen, wenn ein solcher Text im weiteren Verlauf der Transaktion verändert wird (z.B. durch SAVE_TEXT oder DELETE_TEXT). In diesem Fall ist ein erneuter COMMIT_TEXT notwendig, damit diese Änderungen wirksam werden.

Funktionsaufruf:

Syntax Syntax

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

Ende des Quelltextes.

Export-Parameter:

OBJECT	Hier geben Sie den Namen eines Textobjektes an. Es werden dann nur solche Texte auf die Protokolldatei gestellt, die dieses Textobjekt haben. Das Textobjekt kann auch generisch angegeben werden. Ist der Parameter nicht angegeben, so gibt es keine Einschränkung hinsichtlich des Textobjektes. Bezugsfeld: THEAD-TDOBJECT Defaultwert: '*'
NAME	Der Parameter legt den Namen der betroffenen Textbausteine fest. Der Name kann auch generisch angegeben werden. Fehlt der Parameter, so gibt es hinsichtlich des Textnamens keine Einschränkungen. Bezugsfeld: THEAD-TDNAME Defaultwert: '*'
ID	Geben Sie hier die Text-Id der Textbausteine an. Die ID können Sie auch generisch angeben. Fehlt der Parameter, so gibt es hinsichtlich der Text-ID keine Einschränkungen. Bezugsfeld: THEAD-TDID Defaultwert: '*'
LANGUAGE	Über diesen Parameter spezifizieren Sie den Sprachschlüssel der Textbausteine. Die Sprache können Sie auch generisch angeben. Fehlt der Parameter, so gibt es hinsichtlich der Sprache keine Einschränkungen Bezugsfeld: THEAD-TDSPRAS Defaultwert: '*'
SAVEMODE_DIRECT	Der Sicherungsmodus eines Textbausteins (direkt oder über Verbuchung) wird anhand des Textobjekts über die Tabelle TTXOB festgelegt. In bestimmten Fällen ist es jedoch sinnvoll, die verbuchungsseitige Sicherung durch eine sofortige Sicherung des Textes zu ersetzen (z.B. bei Batchprogrammen). Mögliche Werte: ' ' Sicherungsmodus entsprechend Textobjekt 'X' der Textbaustein wird sofort gesichert Defaultwert: SPACE Wenn Sie diesen Parameter mit dem Wert 'X' übergeben, werden die betroffenen Texte sofort auf die Textdatei zurückgeschrieben. Es werden keine Einträge in die Protokolldatei geschrieben. Ein COMMIT WORK für Textbausteine ist nicht notwendig.
KEEP	Mit dem Parameter KEEP steuern Sie, ob die verbuchten Texte weiterhin im Textmemory gehalten werden sollen. Damit ist es möglich, in der laufenden Transaktion weiterhin auf diese Texte zuzugreifen, obwohl noch kein COMMIT WORK abgesetzt wurde. Wird in der Transaktion erneut ein COMMIT_TEXT aufgerufen, so werden die mit KEEP gehaltenen Texte nicht mehr verbucht, es sei denn sie wurden zwischenzeitlich durch den Aufruf von Funktionsbausteinen wie SAVE_TEXT oder DELETE_TEXT verändert. Defaultwert: SPACE

Import-Parameter:

COMMIT_COUNT

Der Parameter gibt die Anzahl der an die Verbuchung übergebenen Textbausteine zurück.

Bezugsfeld: SY-INDEX