WHENEVER { 
SQLERROR 
| SQLWARNING 
| NOTFOUND }
GOTO 
   label 
   | STOP 
   | CONTINUE 
   | { C-code; }

label :  identifier

Die WHENEVER-Anweisung wird verwendet, um Fehlermeldungen, Warnungen und besondere Bedingungen abzufangen, auf welche die Datenbank bei der Verarbeitung von SQL-Anweisungen trifft. Die Anweisung kann in einem Embedded SQL-Programm an eine beliebige Stelle gesetzt werden und erzeugt keinen Code. Der Präprozessor erzeugt nach jeder aufeinanderfolgenden SQL-Anweisung Codes. Die Fehleraktion bleibt für alle Embedded SQL-Anweisungen aus der Quellzeile der WHENEVER-Anweisung bis zur nächsten WHENEVER-Anweisung mit demselben Fehlerzustand oder bis zum Ende der Quelldatei gültig.

Die Standardaktion ist CONTINUE.

Beachten Sie, dass diese Anweisung für den Bedienkomfort in einfachen Programmen bereitgestellt wird. Meistens ist es am einfachsten, das sqlcode-Feld des SQLCA (SQLCODE) direkt zu überprüfen, um Fehlerzustände zu prüfen. In diesem Fall würde die WHENEVER-Anweisung nicht verwendet werden. Die WHENEVER-Anweisung veranlasst nämlich den Präprozessor nur dazu, nach jeder Anweisung einen if(SQLCODE)-Test auszugeben.

Keine.

Keine.

Im Folgenden werden Beispiele für die WHENEVER-Anweisung gegeben:

EXEC SQL WHENEVER NOTFOUND GOTO done;
EXEC SQL WHENEVER SQLERROR
   {
      PrintError( &sqlca );
      return( FALSE );
   };