DBtransactionStart

Top  Previous  Next

Beginn mit Änderungen im Logfile zu protokollieren.

Moskito legt zu jedem Workfile *.wf ein Transaktionslog *.tr an. In dieser Datei werden alle Änderungen am Workfile mitgeführt. Sobald eine Transaktion beendet ist, wird das Logfile physisch geschrieben. Nach erfolgreichem Sichern des Workfiles am Ende einer Moskitositzung wird das Logfile entfernt. Trifft Moskito beim Start auf ein vorhandenes Logfile, so ist Moskito zuvor abgebrochen. Und der Workfileinhalt wird anhand der letzten gültigen Transaktion rekonstruiert. Jede Transaktion kann über Zugriffsfunktionen rückgängig gemacht und wiederhergestellt werden.

Mit dieser Funktion wird eine Transaktion im Logfile begonnen. Das Protokollieren geschieht folgendermaßen: Zuerst wird mit DBtransactionStart ein neuer Eintrag im Logfile erzeugt. Es folgen dann eine oder mehrere Funktionen, die den Inhalt der Datenbank verändern. Zum Schluss wird DBtransactionEnd aufgerufen, die das Änderungsprotokoll in das Logfile schreibt.

Parameter

root (PROOT)                                             [IN]

Handle auf die geöffnete Datenbank.

Ergebnis

(long int)                                                   [OUT]

Existiert kein Logfile wird 0 zurückgeliefert, ansonsten die Größe der geschriebenen Änderungen im Logfile.

Deklaration

#include "database.h"

 

long int DLLENTRY DBtransactionStart (

     PROOT    root

);

Verwandte Funktionen

DBtransactionData

DBtransactionEnd

DBtransactionLevel

DBtransactionRollback

DBtransactionRollforward

DBtransactionSetUndoImpossible