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:
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.
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.
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.