Gestion des erreurs et diagnostics

La zone de communication SQL

La SQLCA (SQL Communication Area) est une structure de données mise à jour par chaque instruction SQL exécutable. Elle est incluse dans la WORKING-STORAGE SECTION avec :

           EXEC SQL INCLUDE SQLCA END-EXEC.

Ses principaux champs sont :

Champ Description
SQLCODE 0 en cas de succès, une valeur positive pour les avertissements et « aucun enregistrement », une valeur négative pour les erreurs
SQLSTATE le code SQLSTATE à 5 caractères de la norme SQL
SQLERRML, SQLERRMC longueur et texte du message d’erreur
SQLERRD(3) nombre de lignes traitées
SQLWARN0 … indicateurs d’avertissement
NoteÀ compléter

Recopier la structure réelle de copy/SQLCA.cpy.

SQLCODE et SQLSTATE

Lorsque la base de données signale une erreur, GixSQL affecte à SQLCODE le code d’erreur de la base de données s’il existe (par exemple -942 pour l’erreur Oracle ORA-00942) et à SQLSTATE le SQLSTATE correspondant. Lorsque l’erreur provient de GixSQL lui-même, SQLCODE est l’un des codes négatifs listés dans Codes d’erreur.

NoteÀ vérifier

Correspondance de SQLCODE pour chaque pilote (PostgreSQL n’a pas de codes numériques).

La condition « aucun enregistrement »

Lorsqu’un SELECT INTO ne trouve aucune ligne, ou qu’un FETCH atteint la fin d’un curseur, SQLSTATE vaut 02000 et SQLCODE vaut 100. Oracle utilise 1403 au lieu de 100 ; pour obtenir cette valeur :

  • précompilez avec --no-rec-code 1403, afin que WHENEVER NOT FOUND teste cette valeur ;
  • exécutez avec GIXSQL_NOREC_CODE=1403, afin que la bibliothèque d’exécution l’utilise.

Les deux réglages doivent être cohérents.

WHENEVER

L’instruction WHENEVER demande au précompilateur de générer un test après chacune des instructions SQL suivantes, jusqu’au prochain WHENEVER pour la même condition :

           EXEC SQL WHENEVER SQLERROR GO TO SQL-ERROR END-EXEC.
           EXEC SQL WHENEVER NOT FOUND GO TO END-OF-FETCH END-EXEC.
           EXEC SQL WHENEVER SQLWARNING CONTINUE END-EXEC.

Conditions :

SQLERROR
SQLCODE est négatif ;
NOT FOUND
la condition « aucun enregistrement » ;
SQLWARNING
un avertissement est positionné.

Actions :

CONTINUE
pas de test (par défaut) ;
GO TO label, GOTO label
saut au paragraphe ou à la section label ;
PERFORM label
exécution (PERFORM) du paragraphe ou de la section label.

WHENEVER est une déclaration : elle s’applique aux instructions qui la suivent dans le source, et non dans l’ordre d’exécution.

Journalisation

Lorsqu’une erreur n’est pas claire d’après la SQLCA, le journal de la bibliothèque d’exécution donne le détail de chaque appel, y compris les instructions SQL envoyées à la base de données (voir Journalisation).