Statusmeldungen und Fehlerbenachrichtigungen bearbeiten

Dieses Kapitel beschreibt mögliche Gründe für die Ablehnung von Objekten während der Funktionsverarbeitung, die nach der Verarbeitung angezeigten Statusmeldungen und die Fehlerbenachrichtigung während der Verarbeitung.

• Ablehnung von Objekten und Ursache

• Status-Meldungen

• SYSMAIN-Fehlerbenachrichtigung

Ablehnung von Objekten und Ursache

Wenn bei der Ausführung einer SYSMAIN-Funktion ein oder mehrere Objekte gefunden wurden, die den angegebenen Auswahlkriterien entsprechen, aber einige oder alle dieser Objekte zur weiteren Verarbeitung abgelehnt wurden, tritt einer der folgenden Natural-Systemfehler auf:

Sie können das SYSMAIN-Kommando TOTAL (siehe An SYSMAIN absetzbare spezielle Kommandos) benutzen, um den individuellen Status einer Anfrage zu überprüfen.

Mögliche Gründe für die Ablehnung von Objekten sind im folgenden Abschnitt beschrieben:

• Ungültige Angaben zu Objekttyp, Datum/Uhrzeit, Benutzer oder Terminal

• Identischer Name in der Zielumgebung

• XREF und User Exits

• Keine kurze oder erweiterte Fehlermeldung

• Library-Einschränkungen

Ungültige Angaben zu Objekttyp, Datum/Uhrzeit, Benutzer oder Terminal

• Ein Objekt wurde ausgewählt und dann abgelehnt, weil der Objekttyp für die angegebene Art der Verarbeitung nicht gültig war. Bei der Verarbeitung von Programmierobjekten werden beispielsweise alle Maps abgelehnt, wenn die Verarbeitung auf Objekte vom Typ Programm oder Subroutine beschränkt wurde.

• Ein Objekt wurde ausgewählt und dann abgelehnt, weil das Datum oder die Uhrzeit, zu der das angegebene Objekt gespeichert oder katalogisiert wurde, nicht in dem angegebenen Datums- oder Zeitbereich liegt.

• Ein Objekt wurde ausgewählt und dann abgelehnt, weil die Benutzerkennung oder Terminal-Kennung, unter der das angegebene Objekt gespeichert oder katalogisiert wurde, nicht mit der angegebenen Benutzerkennung oder Terminal-Kennung übereinstimmte.

• Ein katalogisiertes Objekt wurde ausgewählt und dann abgelehnt, weil der Profilparameter RECAT auf ON gesetzt war und es kein gespeichertes (Quellcode-)Objekt gab, das dem katalogisierten Objekt entsprach. Siehe auch Profilparameter RECAT verwenden.

• Es wurde (nur) ein gespeichertes Objekt ausgewählt und dann abgelehnt, weil der Profilparameter RECAT auf ON gesetzt war und die Zielumgebung bereits ein katalogisiertes Objekt mit demselben Namen enthielt. Siehe auch Profilparameter RECAT verwenden.

Identischer Name in der Zielumgebung

• Ein Objekt wurde ausgewählt und dann abgelehnt, weil die Zielumgebung bereits ein Objekt mit demselben Namen enthielt und die Ersetzungsoption nicht aktiviert war (Feld Replace auf N gesetzt oder Schlüsselwort REPLACE nicht angegeben).

• Ein katalogisiertes Programmierobjekt vom Typ S (Subprogramm) wurde ausgewählt und dann abgelehnt, weil der Name der externen Subroutine mit dem Namen einer anderen Subroutine in der Ziel-Library identisch war.

• Ein katalogisiertes Programmierobjekt vom Typ 4 (Class) wurde ausgewählt und dann zurückgewiesen, weil der Name der externen Class mit dem Namen einer anderen Class in der Ziel-Library identisch war.

XREF und User Exits

• Die Option XREF war aktiviert (Feld XREF nicht auf N gesetzt oder Schlüsselwort XREF angegeben) und es waren keine XRef-Daten für das angegebene Programmierobjekt vorhanden.

• Eine User-Exit-Routine war aktiv, und bei der Verarbeitung des Objekts wurde ein Rückgabe-Code ungleich Null zurückgegeben.

Keine kurze oder erweiterte Fehlermeldung

• Eine erweiterte (lange) Fehlermeldung wurde ausgewählt und dann abgelehnt, weil keine entsprechende kurze Fehlermeldung in der Quell-Library vorhanden war.

• Eine erweiterte (lange) Fehlermeldung wurde ausgewählt, konnte aber nicht verarbeitet werden, weil es in der Zielumgebung keine entsprechende kurze Fehlermeldung gab.

• Eine kurze Fehlermeldung wurde zum Verschieben (Move), Löschen (Delete) oder Umnummerieren (Rename) ausgewählt, konnte aber nicht verarbeitet werden, weil der entsprechende erweiterte Fehlertext nicht in den Auswahlkriterien enthalten war. Zu einer erweiterten Fehlermeldung muss immer eine entsprechende kurze Fehlermeldung vorhanden sein.

Library-Einschränkungen

• Es wurde eine Library angegeben, die von Predict Application Control/Predict Application Audit kontrolliert wird, und das Objekt kann nicht von SYSMAIN behandelt werden.

Status-Meldungen

Die folgende Tabelle beschreibt die Statusmeldungen, die in der Spalte Message eines Auswahlbildschirms oder in einem Batch-Report (siehe auch Online Report-Modus) angezeigt werden können, nachdem eine SYSMAIN-Funktion auf einem Objekt ausgeführt wurde. Die erwähnten Zeilenkommandos finden Sie unter Auswahllisten in den objekttypspezifischen Abschnitten dieser Dokumentation.

SYSMAIN-Fehlerbenachrichtigung

SYSMAIN versucht im Falle eines Laufzeitfehlers während der Verarbeitung immer eine Wiederherstellung zu erreichen. Diese Funktion wird automatisch aktiviert und verwendet die Systemvariable *ERROR-TA (siehe auch *ERROR-TA in der Systemvariablen-Dokumentation). Diese Funktion wird deaktiviert, wenn SYSMAIN normal beendet wird.

Wenn ein Terminalkommando (siehe auch %% und %. — Aktive Operation unterbrechen in der Terminalkommandos-Dokumentation) zum Beenden von SYSMAIN verwendet, wird dies als abnormales Beenden betrachtet, und die Systemvariable *ERROR-TA wird nicht zurückgesetzt. Sie kann zurückgesetzt werden, indem SYSMAIN erneut aufgerufen und normal beendet wird. Falls Sie die Systemvariable *ERROR-TA gesetzt haben, setzt SYSMAIN sie beim Beenden auf den zuvor zugewiesenen Wert zurück.

Wenn in Bezug auf die Auswahlkriterien ungültige Daten angegeben wurden, wird eine Fehlermeldung in der Meldungszeile ausgegeben. Wenn Sie sich über die Bedeutung der kurzen Fehlermeldung unsicher sind, können Sie mit dem Spezialkommando DISPLAY (siehe auch An SYSMAIN absetzbare spezielle Kommandos) eine Anzeige des entsprechenden erweiterten (langen) Fehlermeldungstextes aktivieren.

In diesem Abschnitt werden die folgenden Themen behandelt:

• Fehler bei der Dateneingabe

• Fehler bei der Verarbeitung

Fehler bei der Dateneingabe

Wenn in Bezug auf die Auswahlkriterien ungültige Daten angegeben wurden, wird in der Meldungszeile eine Fehlermeldung angezeigt. In einigen Fällen wird die Online-Hilfe für bestimmte Einträge aufgerufen. Dadurch erhalten Sie genauere Informationen zu dem Fehler.

Tritt ein Fehler im Batch-Modus auf, wird eine Fehlermeldung und die entsprechende Fehlernummer ausgegeben und das SYSMAIN-Dienstprogramm beendet.

Fehler bei der Verarbeitung

Wenn Sie eine Anforderung stellen, die einen Verarbeitungsfehler verursacht, gibt SYSMAIN einen Fehlerbericht aus, wie im folgenden Beispiel gezeigt:

16:51:08           *** SYSMAIN Error Report ***          2005-08-10

The following internal error occurred while processing the
SYSMAIN function xxxxxx (cc):

   Error in field specification for IF SELECTION statement.


Error Number .. eeee
Program ....... pppppppp
Status Code ... s          Status ...... tttttttt
Line .......... llll       Level ....... vv
Device ........ dddddddd
User ID ....... uuuuuuuu   User Name ... nn...nn

Die in dem Fenster enthaltenen Informationen sind nützlich, um die Fehlerursache zu analysieren.

Die Werte im obigen Fenster haben die folgenden Bedeutungen:

Wenn ein Verarbeitungsfehler auftritt, notieren Sie die Informationen im Fenster und drücken Sie ENTER. Das Dienstprogramm SYSMAIN versucht, zum letzten aktiven Menü-Bildschirm zurückzukehren, wobei die Datenwerte der Eingabefelder unverändert bleiben.

Wird in dem Fenster das spezielle Kommando DISPLAY eingegeben (siehe auch An SYSMAIN absetzbare spezielle Kommandos), wird der erweiterte (lange) Meldungstext zu dem aufgetretenen Fehler angezeigt.

Tritt während der Batch-Verarbeitung ein Verarbeitungsfehler auf, gibt das Dienstprogramm SYSMAIN die entsprechende Fehlermeldung aus und wird beendet.

Bestimmte Benutzerfehler können ebenfalls zur Anzeige des Fensters führen. Obwohl SYSMAIN versucht, alle Fehler während der Auswertung abzufangen, ist dies nicht immer ganz erfolgreich. Wenn ein Benutzer beispielsweise verlangt, dass ein DDM von einer Umgebung in eine andere kopiert wird, aber eine ungültige Datenbankkennung (DBID) angibt, versucht SYSMAIN, auf diese Datenbank zuzugreifen. Es wird ein Adabas-Antwortcode 148 zurückgegeben, und die Transaktion SYSMAIN ERROR wird aufgerufen und das Fenster angezeigt. In ähnlicher Weise kann eine ungültige Datei zu einer Reihe von Fehlern führen, die von der Datenbank gesendet werden.

In Situationen, in denen ein Adabas-Antwortcode 9 zurückgegeben wird, schreibt SYSMAIN eine Nachricht, die Sie über den Fehler informiert, und beginnt die Verarbeitung wieder bei der letzten Funktion oder dem letzten Menü. Wenn eine bestimmte Anforderung nicht erledigt wurde, können Sie davon ausgehen, dass der Antwortcode 9 zu einem BACKOUT TRANSACTION zur letzten nicht abgeschlossenen Transaktion führte.