Anwendungsgebiet: Kommando-Returncode
Die Funktion SUBCODE1( ) liefert die Fehlerklasse des aktuellen Kommando-Returncodes, das heißt des Returncodes des Kommandos, das einen Fehler auslöste oder dem das Kommando SAVE-RETURNCODE folgte.
Kommando-Returncodes bestehen aus drei Komponenten: Subcode1 und Subcode2, die die Fehlerklasse und die Fehlergewichtung anzeigen, und Maincode, der den siebenstelligen Fehlerschlüssel enthält.
Diese Komponenten werden mit den Funktionen SUBCODE1( ), SUBCODE2( ) und MAINCODE( ) ausgewertet. Zu dem Maincode (Fehlerschlüssel) kann mit der Funktion MSG( ) die dazugehörende Meldung ausgegeben werden.
Außerhalb von Prozeduren und Dialogblöcken ist SUBCODE1( ) nicht verfügbar.
Format
SUBCODE1( ) SC1( ) |
Ergebnistyp
INTEGER (<integer 0..255>)
Eingabeparameter
Keine
Ergebnis
Bezeichnung der Fehlerklasse als Integer-Wert <integer 0..255>
0
In der aktuellen Prozedur ist noch kein Fehler aufgetreten oder der Returncode wurde nach einem fehlerfreien Kommando mit /SAVE-RETURNCODE gesichert.
Fehlermeldungen
SDP0428 KOMMANDO-RETURNCODE KANN IM DIALOG NICHT ABGEFRAGT WERDEN SDP0435 GEWUENSCHTE INFORMATION NICHT VERFUEGBAR
Beispiel
Fehlerbehandlung mit SUBCODE1( )
/DECLARE-VARIABLE MYVAR /... /DECLARE-VARIABLE MYVAR "schon deklariert" /SAVE-RETURNCODE /IF ((SUBCODE1=0) AND (SUBCODE2=1)) / WRITE-TEXT 'Variable ist schon deklariert' /END-IF