Alle SDF-P-Kommandos liefern Returncodes, die den Benutzer über die Ausführung des Kommandos informieren. Dieser Kommando-Returncode ist vergleichbar mit dem Returncode auf Programmebene. Der Kommando-Returncode ermöglicht es dem Benutzer, auf Fehlersituationen zu reagieren.
Der Kommando-Returncode besteht aus drei Teilen:
dem Subcode1, der die aufgetretene Fehlersituation in eine Fehlerklasse einordnet, aus der abgeleitet werden kann, wie schwer wiegend ein Fehler ist. Der Wert von Subcode1 wird dezimal ausgegeben.
dem Subcode2, der Zusatzinformationen zur Fehlerklasse enthalten kann.
dem Maincode, der einem Meldungsschlüssel entspricht und differenzierte Fehlerinformationen liefert. Mit diesem Meldungsschlüssel kann über die vordefinierte Funktion MSG( ) oder mit dem Kommando HELP-MSG-INFORMATION die entsprechende Fehlermeldung ausgegeben werden.
Der Kommando-Returncode kann mit den vordefinierten Funktionen SUBCODE1( ), SUBCODE2( ) und MAINCODE( ) abgefragt werden.
Es gibt für jedes Kommando eigene Returncodes. Auch gibt es neben den eigenen Returncodes für bestimmte Kommandotypen noch übergreifende Returncodes, die hier anschließend aufgelistet werden.
Die allgemeinen Returncodes (d. h. Returncodes, die bei jedem Kommando auftreten können) sind:
(SC2) | SC1 | Maincode | Bedeutung 1) |
0 | CMD0001 | Ohne Fehler | |
1 | CMD0202 | Syntaxfehler | |
3 | CMD2203 | Falsche Syntaxdatei | |
32 | CMD0221 | Systemfehler (interner Fehler) | |
130 | SDP0099 | Kein Adressraum mehr verfügbar |
1)Enthält die Tabelle auch garantierte Meldungen, wird die Bedeutungsspalte mit "/ garantierte Meldungen"ergänzt".
Bei allen Kommandos, Anweisungen und Datensätzen in denen eine Ausdrucksersetzung stattfindet, können die folgenden Returncodes auftreten, wenn bei der Ausdrucksersetzung Fehler passieren:
(SC2) | SC1 | Maincode | Bedeutung |
1 | SDP0140 | Syntaxfehler während der Ersetzung | |
64 | SDP0141 | Semantikfehler während der Ersetzung |
Bei allen Datenzeilen in falschem Kontext kann folgender Returncode auftreten:
(SC2) | SC1 | Maincode | Bedeutung |
64 | SDP0091 | Semantikfehler |
Bei allen Anweisungen in falschem Kontext kann folgender Returncode auftreten:
(SC2) | SC1 | Maincode | Bedeutung |
64 | SDP0091 | Semantikfehler |
Garantierte Meldung
Der Zusatz „garantierte Meldung“ in der Returncode-Tabelle bedeutet:
Für ausgewählte Meldungen werden der Meldungsschlüssel und die Inserts (Numerierung und inhaltliche Zuordnung) garantiert.
Sofern in Verbindung mit einem Returncode garantierte Meldungen existieren, werden die Meldungsnummern nach dem Bedeutungstext aufgelistet.