BK Begin mirror update

Version 6.0

BK Begin mirror update

Parameter	Typ		Beschreibung
Dieser Befehl benötigt keine Parameter
Funktionsergebnis	Ganzzahl		0 bei korrekter Ausführung,
			sonst Fehlermeldung

Sie müssen alle Befehle und Funktionen von 4D Backup mit BK Begin mirror update bzw. BK Begin full backup und BK END BACKUP umrahmen — davon ausgenommen sind vier unabhängige Routinen. Weitere Informationen dazu finden Sie im Abschnitt Struktur der Anweisungen.

BK Begin mirror update ist eine dieser unabhängigen Routinen. Sie löst direkt das Aktualisieren des Spiegels aus. Gleichzeitig wird die aktuelle Logbuchdatei geschlossen. Sie erhält unter Windows die Endung ".4L2", auf MacOS ".2". Es wird eine neue Logbuchdatei angelegt.

Arbeiten Sie mit 4D Server, beginnt das neue Logbuch die in der Datenbank ausgeführten Operationen zu speichern. Das Senden des Logbuchs an den Spiegelserver beeinträchtigt nicht den laufenden Betrieb, da die bisherige Logbuchdatei (nun mit der Endung ".4L2" oder ".2") nicht mehr aktiv ist. Die Logbuchdatei wird mit der Funktion BK Start copy gesendet.

Ist das Senden abgeschlossen und das Logbuch integriert, werden die Daten der Spiegeldatenbank auf dem Spiegelrechner unter dem Namen des Backup-Projekts gesichert.

Hinweis: Weitere Informationen zum Aktualisieren des Spiegelservers finden Sie im Handbuch 4D Backup Benutzermodus im Kapitel "Einen logischen Spiegel verwenden".

BK Begin mirror update gibt den Wert 0 (Null) zurück, wenn die Ausführung korrekt ist. Andernfalls erhalten Sie eine Fehlernummer. Weitere Informationen dazu finden Sie im Anhang A, Fehlermeldungen von 4D Backup).

Wir empfehlen, den zurückgegebenen Wert systematisch zu prüfen, denn alle nachfolgenden Anweisungen werden ignoriert, wenn nicht der Wert 0 (Null) zurückgegeben wird.

Hauptmerkmal bei der Aktualisierung eines logischen Spiegels ist, daß die Datenbank im Mehrplatzbetrieb nicht gesperrt wird: Alle an den 4D Server angeschlossenen Arbeitsstationen können im Schreib- und Lesemodus weiterarbeiten.

In 4th Dimension Einzelplatz werden - wie bei der vollständigen Sicherung - alle Prozesse, außer dem Prozeß, der die Aktualisierung auslöst, in Schlafstellung gesetzt.

BK Begin mirror update wird, analog zur Funktion BK Begin full backup, erst ausgeführt, wenn alle laufenden Transaktionen abgeschlossen sind. Sie müssen - wie bei der vollständigen Sicherung - vor Aufrufen dieser Funktion sicherstellen, daß keine Transaktion im gleichen Prozeß gestartet wurde.

Rufen Sie den Befehl BK END BACKUP auf, wenn der Spiegelserver nicht oder noch aktualisiert wird, werden alte und neue Logbuchdatei wieder zusammengelegt, um zum vorherigen Zustand zurückzukehren.

(1) Die einfachste Methode zum Aktualisieren des Spiegels lautet:

   C_INTEGER($vError)
   $vError:=BK Begin mirror update

(2) Nachfolgende Methode verwaltet selbstständig das Aktualisieren einer Spiegeldatenbank:

   If (BK Begin mirror update=0)
      If (BK Start copy =0)
         Repeat 
         Until (BK Get state #4)
      End if
      BK END BACKUP 
   End if

(3) Diese Methode läßt sich noch um die Fehlerverwaltung erweitern:

   C_INTEGER($vError;$vState)
   $vError:=BK Begin mirror update
   If ($vError#0)
      ALERT("Aktualisierung läßt sich nicht starten: Fehlernr " +String($vError))
   Else 
      $vError:=BK Start copy
      If ($vError#0)
         ALERT("Logbuchdatei läßt sich nicht senden: Fehlernr " + String($vError))
      Else 
         Repeat
            $vState:=BK Get state
         Until ($vState#4)
         If ($vState#5)
            ALERT("Probleme während dem Kopieren: Fehlernr " + String($vState))
         End if
      End if 
      BK END BACKUP
   End if

BK Begin full backup, BK END BACKUP.