|
|
|
|
|
|
|
|
|
Version 6.0
BK Get state
| Parameter | Typ | Beschreibung | ||||
| Dieser Befehl benötigt keine Parameter | ||||||
| Funktionsergebnis | Ganzzahl |  | Stand des Sicherungsvorgangs | |||
Beschreibung
Mit der Funktion BK Get state läßt sich der Verlauf der vollständigen Sicherung bzw. die Aktualisierung des Spiegelservers anzeigen. Ein Ablaufbalken zeigt den Stand des 4D Backup Prozesses an.
BK Get state können Sie aufrufen:
• vor der Kopie,
• während der Kopie,
• nach der Kopie.
Verwechseln Sie BK Get state nicht mit der Funktion BK Get error number. BK Get state zeigt den aktuellen Stand des Sicherungsvorgangs an. So sehen Sie z.B., daß der Kopiervorgang abgeschlossen ist und können die Methode mit dem Befehl BK END BACKUP schließen. BK error number gibt dagegen nur bei Problemen eine Fehlernummer zurück.
Nach dem Starten des Kopiervorgangs müssen Sie von Zeit zu Zeit die Funktion BK Get state aufrufen. Das hat zwei Gründe:
• Die Funktion zeigt den Status des Sicherungsvorgangs an,
• Die Funktion weist dem Sicherungsvorgang Prozeßzeit zu, damit der Kopiervorgang fortgeführt wird. Andernfalls wird der Vorgang nicht weiter ausgeführt.
BK Get state gibt folgende Werte zurück:
• 1: Es wurde kein Volume ausgewählt.
Sie haben den Sicherungsvorgang gestartet und kein Volume dafür gewählt. Wählen Sie mit dem Befehl BK SET VOLUME ein Volume. Starten Sie die Sicherung ohne dazugehöriges Volume, erhalten Sie eine Fehlermeldung. Die Sicherung wird nicht ausgeführt.
• 2: Das gewählte Volume kann nicht verwendet werden.
Das über das Projekt bzw. den Befehl BK SET VOLUME gewählte Volume eignet sich nicht für die Sicherung, weil die Speicherkapazität nicht ausreicht oder dieses nicht mehr vorhanden ist. Evtl. befindet sich keine Diskette im Laufwerk.
• 3: Bereit für Kopie.
Alles ist bereit, die Sicherung kann starten: Das Volume ist ausgewählt und geeignet, der Spiegelserver ist in Wartestellung, etc.
Wir empfehlen, diesen Test über die Funktion BK Start copy vor dem Starten der Kopie durchzuführen.
• 4: Kopie läuft.
Der Kopiervorgang läuft korrekt ab. Mit dem Befehl BK GET PROGRESS oder den beiden Plug-In Bereichen %BACKUP PROGRESS und %FILLING PROGRESS können Sie das Fortschreiten des Kopiervorgangs anzeigen.
• 5: Kopie beendet.
Der Kopiervorgang ist korrekt abgelaufen. Sie können nun den Befehl BK END BACKUP aufrufen, um den Kopiervorgang abzuschließen.
• 6: Sicherung wurde nicht gestartet.
Sie haben die Funktionen BK Begin full backup bzw. BK Begin mirror update entweder nicht aufgerufen oder sie funktionieren nicht. Der von der jeweiligen Funktion zurückgegebene Wert gibt den Grund dafür an.
• 7: Sicherung ist gescheitert.
Die Funktion BK Start copy wurde gestartet, jedoch durch ein Problem unterbrochen.
Beispiel
Es zeigt die Standardeinstellung einer Sicherung mit kompletter Verwaltung der möglichen Stadien:
C_INTEGER($State;$Progress;$Fill)
If(BK Begin full backup#0)
ALERT("Die Sicherung kann nicht gestartet werden.")
Else
MESSAGE("Sicherung läuft…")
BK OPEN PROJECT("wöchentliche Sicherung")
$State:=BK Get state
Case of
:($State=1)
ALERT("Es wurde kein Volume ausgewählt.")
:($State=2)
ALERT("Das gewählte Volume kann nicht verwendet werden.")
:($State=3)
If(BK Start copy#0)
ALERT("Die Sicherung kann nicht gestartet werden")
Else
Repeat
BK GET PROGRESS($Progress;$Fill)
MESSAGE("Sicherung läuft: "+String($Progress)+"%")
Until(BK Get state#4)
If(BK Get state=5)
MESSAGE("Die Sicherung ist korrekt abgelaufen.")
Else
ALERT("Probleme während der Sicherung.")
End if
End if
End case
BK END BACKUP
End if |
|
|
|
|
|
|
|
|