4D Doc Center : INTEGRATE MIRROR LOG FILE

Home

4D v14.3

INTEGRATE MIRROR LOG FILE


INTEGRATE MIRROR LOG FILE ( PfadName {; OperationNr} )

Parameter	Typ	Beschreibung
PfadName	Text	Name oder Pfadname des zu integrierenden Logbuchs
OperationNr	Variable Zahl	Nummer der Operation, wo die Integration beginnt
		Nummer der zuletzt integrierten Operation

Beschreibung

Der Befehl INTEGRATE MIRROR LOG FILE integriert das Journal, das im Parameter PfadName angegeben ist, in eine 4D Server Datenbank, optional ab der Operation, angegeben in OperationNr. Dieser Befehl erlaubt, jedes Journal in die Datenbank zu integrieren, auch wenn es nicht dem aktuellen Status der Datendatei entspricht. Er eignet sich speziell zur Verwendung im Kontext einer Spiegeldatenbank.

Hinweis: Ab 4D v14 lässt sich ein Journal als Teil einer Spiegeldatenbank verwenden. Die Option "Benutze Logbuch" ist auch in den Datenbank-Eigenschaften eines 4D Server verfügbar, der als Spiegel-Server verwendet wird. Auf diese Weise ist das Implementieren einer Reihe verschachtelter Spiegel-Server möglich.

Dieser Befehl ersetzt, im Gegensatz zum Befehl INTEGRATE LOG FILE am Ende der Ausführung nicht das aktuelle Journal durch das integrierte: Das aktuelle Journal der Datenbank wird weiter verwendet. So werden alle Änderungen während der Integration im aktuellen Journal gesichert.

In PfadName übergeben Sie einen absoluten oder relativen Pfad des Datenbankordners. Übergeben Sie einen leeren String, erscheint ein Standard-Öffnen Dialog, so dass Sie die Datei zum Integrieren wählen können. Wird es abgebrochen, wird keine Datei integriert und die Systemvariable OK auf 0 gesetzt.

Standardmäßig, d.h. ohne den Parameter OperationNr, integriert der Befehl alle Operationen des Journals.
Übergeben Sie einen Wert in OperationNr, beginnt die Integration mit dem angegebenen Wert. Haben Sie eine Variable übergeben, enthält dieser Parameter die Nummer der zuletzt integrierten Operation. So können Sie nachfolgende Logbücher direkt im Anschluss integrieren, d.h. beim nächsten Aufruf von INTEGRATE MIRROR LOG FILE diesen zurückgegebenen Wert in OperationNr übergeben.

Nachfolgende Übersicht (Pseudocode) zeigt verschiedene Fälle zum Integrieren des Journals. Im zu integrierenden Journal ist X die Nummer der ersten Operation und Y die Nummer der letzten Operation:

Case of
    : (operationNum < X-1)
                        --> Fehler  1260 (Gewähltes Journal ist zu neu)
    : (operationNum >= X-1) und (operationNum <= Y) 
                        --> Start integration
        Case of
            : (Type of operation = "Addition")
                If (Record exists)
                        --> Nichts machen
                Else
                        --> Datensatz hinzufügen
                End if
            : (Type of operation = "Modification")
                If (Record exists)
                        --> Datensatz ändern
                Else
                        --> Nichts machen
                End if
            : (Type of operation = "Deletion")
                If (Record exists)
                        --> Datensatz löschen
                Else
                        --> Nichts machen
                End if
        End case
    Else// operationNum > Y
                        --> Fehler 1261 (Ausgewähltes Journal ist zu alt) 
End case

Beachten Sie, dass die Integration beim ersten gefundenen Fehler stoppt. Wollen Sie trotzdem mit der Integration fortfahren, müssen Sie das MSC verwenden.

Systemvariablen und Mengen

Bei korrekt ausgeführter Integration wird die Systemvariable OK auf 1 gesetzt; andernfalls auf 0 (Null).