Gibt den Dateinamen einer DLL (oder eines gemeinsam genutzten Objekts unter Unix) an, die die Callback-Funktion für ein volles Dateisystem (File System Full) enthält

Syntax

{ dbsrv11 | dbeng11 } -fc Dateiname ...

Gilt für

Alle Betriebssysteme und Datenbankserver.

Bemerkungen

Diese Option kann dazu verwendet werden, um Benutzer zu benachrichtigen und gegebenenfalls Gegenmaßnahmen zu ergreifen, wenn im Dateisystem Platzmangel droht. Wenn Sie die Option -fc verwenden, versucht der Datenbankserver, die angegebene DLL zu laden und den Eintrittspunkt der Callback-Funktion während des Startens zu finden. Wenn der SQL Anywhere-Datenbankserver weder die DLL noch den Eintrittspunkt finden kann, gibt der Datenbankserver einen Fehler zurück und fährt herunter. Die DLL wird vom Benutzer übergeben und kann Callbacks unter Anderem dazu verwenden, um eine von Ihnen angegebene Anweisungfolgedatei (oder ein Shell-Skript unter Unix) für Diagnose- bzw. Fehlerbehebungsmaßnahmen aufzurufen. Alternativ dazu kann die Callback-Funktion selbst so eine Maßnahme durchführen.

Ein Beispiel für eine Callback-Funktion für volles Dateisystem befindet sich unter Beispielverzeichnis\SQLAnywhere\DiskFull.

Hinweise zum Beispielverzeichnis finden Sie unter Beispielverzeichnis.

SQL Anywhere sucht nach der Callback-Funktions-DLL an demselben Standort, wo er auch nach anderen DLLs und Dateien sucht.

Weitere Hinweise darüber, wo SQL Anywhere nach Dateien sucht, finden Sie unter Wie SQL Anywhere die Dateien findet.

Wenn der Datenbankserver Speichermangel im Dateisystem ermittelt, ruft er die Callback-Funktion auf (falls eine angegeben wurde), indem er folgende Informationen übergibt:

Der Rückgabecode vom Aufruf an xp_out_of_disk zeigt an, ob der Vorgang, der die Bedingung bewirkte, abgebrochen oder erneut versucht werden soll. Wenn ein Wert ungleich NULL zurückgegeben wird, bricht der Vorgang ab, andernfalls wird er erneut versucht. Die Callback-Funktion wird immer wieder aufgerufen, solange sie null zurückgibt und der Dateisystem-Vorgang fehlschlägt.

Auf Microsoft Windows-Plattformen wird, wenn der Datenbankserver mit einem Meldungsfenster des Datenbankservers gestartet (weder -qi noch -qw angegeben) und keine Callback-DLL zur Verfügung gestellt wurde, ein Fenster angezeigt, wenn die Festplatte zu voll wird. Dieses Fenster enthält den DBSpce-Namens- und Fehlercode. Der Benutzer kann nun entscheiden, ob der Vorgang, der den Speichermangel auf der Festplatte bewirkt, erneut versucht oder abgebrochen werden soll.

Bei allen anderen Betriebssystemen gilt: Wenn -fc nicht angegeben ist und Speichermangel auf der Festplatte auftritt, wird ein schwerwiegender Fehler gemeldet.

Sie können Systemereignisse erstellen, um den verfügbaren Speicherplatz von Computern zu protokollieren, die die Datenbankdatei, die Logdatei oder die temporäre Datei enthalten, und um Administratoren bei Speichermangel zu warnen.

Weitere Hinweise finden Sie unter CREATE EVENT-Anweisung.

Siehe auch

• Callback-Funktionen verwenden
• Systemereignisse verstehen
• max_temp_space-Option [Datenbank]
• temp_space_limit_check-Option [Datenbank]

Beispiel

Wenn der Datenbankserver startet, versucht er, die diskfull.dll-DLL zu laden.

dbeng11 -fc diskfull.dll