DB2 Universal Database - Systemverwaltung


Fehlerbehandlung

Damit der Datenbankmanager die Rückkehrcodes vom Benutzer-Exit-Programm ordnungsgemäß verarbeiten kann, muß das Programm so geschrieben sein, daß bestimmte Rückkehrcodes zum Anzeigen bestimmter Ergebnisse ausgegeben werden.

Tabelle 76 zeigt die Rückkehrcodes, die von einem Benutzer-Exit-Programm übergeben werden können, sowie die Interpretation dieser Rückkehrcodes durch den Datenbankmanager. Wenn ein Rückkehrcode in dieser Tabelle nicht aufgeführt ist, wird der so behandelt, als hätte er den Wert 32.

Tabelle 76. Rückkehrcodes von Benutzerausgängen und Ergebnisse
Rückkehrcode Ergebnis (Anm. 1) Erläuterung
0 -- Erfolgreich beendet.
4 Anm. 2 Temporärer Ressourcenfehler trat auf.
8 Anm. 2 Bedienereingriff ist erforderlich.
12 Anm. 3 Hardwarefehler.
16 Anm. 3 Fehler bei Benutzer-Exit-Programm oder einer vom Programm verwendeten Softwarefunktion.
20 Anm. 3 Fehler bei einem oder mehreren der Parameter, die an das Benutzer-Exit-Programm übergeben wurden. Stellen Sie sicher, daß das Benutzer-Exit-Programm die übergebenen Parameter korrekt verarbeitet.
24 Anm. 3 Das Benutzer-Exit-Programm wurde nicht gefunden. Bei OS/2 bedeutet diese Fehlernachricht auch, daß eine Datei, die zur Durchführung einer Operation RESTORE DATABASE benötigt wurde, nicht auf den aktuellen Sicherungsdatenträgern gefunden werden konnte.
28 Anm. 3 E/A-Fehler oder Fehler des Betriebssystems.
32 (und alle anderen Werte) Anm. 3 Das Benutzer-Exit-Programm wurde durch den Benutzer beendet.

Anmerkungen:

  1. Nur für Archivierungs- und Abrufaktionen gültig.

  2. Beim Archivieren und Abrufen bewirkt ein Rückkehrcode 4 oder 8 eine Wiederholung nach fünf Minuten. Die Anforderung eines Archivs, die dieselbe Protokolldatei betrifft, wird nach fünf Minuten wiederholt.

  3. Aufrufe für Benutzer-Exit-Programme werden fünf Minuten lang zurückgestellt. Während dieser Zeit werden alle Anforderungen ignoriert, einschließlich der Protokolldateianforderung, die den Rückkehrcode verursachte.

    Nach Ablauf der fünfminütigen Zurückstellung, in der keine Anforderungen verarbeitet wurden, wird die nächste Anforderung verarbeitet. Wenn bei Verarbeitung dieser Anforderung kein Fehler auftritt, dann wird die Verarbeitung neuer Anforderungen des Benutzer-Exit-Programms fortgesetzt. Wenn ein Rückkehrcode von größer als 8 während der Wiederholung generiert wird, werden Anforderungen für weitere fünf Minuten zurückgestellt. Die fünfminütigen Zurückstellungen werden solange fortgesetzt, bis das Problem behoben wurde oder die Datenbank gestoppt und erneut gestartet wurde.

    Sobald alle Anwendungen die Verbindung mit der Datenbank beenden und die Datenbank anschließend erneut geöffnet wird, wird die Anforderung wiederholt, die die fehlerverursachende Protokolldatei betrifft. Wenn sie erfolgreich verarbeitet wird, werden die zusätzlichen Anforderungen verarbeitet, die während der Zurückstellung generiert wurden.

    Wenn das Benutzer-Exit-Programm zum Archivieren von Protokolldateien aufgerufen wurde, befinden sich möglicherweise viele Protokolldateien auf Ihrer Platte, und die Leistung des Systems kann sich durch den zusätzlichen Aufwand zur Formatierung dieser Protokolldateien verschlechtern. Wenn die Platte voll ist, nimmt der Datenbankmanager keine weiteren Anwendungsanforderungen für Datenbankänderungen mehr entgegen.

    Wenn das Benutzer-Exit-Programm zum Abrufen von Protokolldateien aufgerufen wurde, wird die aktualisierende Wiederherstellung ausgesetzt, aber nicht gestoppt, außer wenn ein Stopp im Dienstprogramm ROLLFORWARD DATABASE angegeben wurde. Wurde kein Stopp angegeben, können Sie den Fehler beheben und die Wiederherstellung wiederaufnehmen.

  4. Bei Archivierungs- und Abrufaktionen wird ein Alert für alle Rückkehrcodes außer 0, 4 und 24 ausgegeben. Der Alert enthält den Rückkehrcode vom Benutzer-Exit-Programm und eine Kopie der Eingabeparameter, die an das Benutzer-Exit-Programm übergeben wurden.

Da das Benutzer-Exit-Programm durch den Befehlsprozessor des Betriebssystems aufgerufen wird, besteht die Möglichkeit, daß Rückkehrcodes ungleich null vom Betriebssystem übergeben werden. Diese Fehlercodes werden nicht neu zugeordnet. Eine Beschreibung dieser Fehlercodes können Sie den Hilfeinformationen für die Nachrichten des Betriebssystems entnehmen.

Fehlerbehandlung unter OS/2:

Bei den Dienstprogrammen BACKUP DATABASE und RESTORE DATABASE bewirken alle von einem Benutzer-Exit-Programm übergebenen Rückkehrcodes ungleich null, daß das Dienstprogramm fehlschlägt und kein erneuter Versuch unternommen wird. Die Dienstprogramme melden einen allgemeinen SQLCODE -2029. Der Nachrichtentext für diesen SQLCODE zeigt den vom Benutzer-Exit-Programm oder vom Betriebssystem übergebenen Rückkehrcode an.


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]