Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

SYSTOOLS.SQLCODE_INFO

Décrire un code SQLCODE

Renvoie l'identifiant et le texte du message associé à un SQLCODE, pour comprendre rapidement une erreur SQL.

À quoi ça sert

Une application ou un programme renvoie souvent un SQLCODE négatif sans texte. Cette fonction de table prend le code dans P_SQLCODE et renvoie l'identifiant du message (MESSAGE_ID), son texte (MESSAGE_TEXT) et le texte de second niveau (MESSAGE_SECOND_LEVEL_TEXT), qui détaille la cause et la reprise.

Elle remplace la recherche manuelle du message dans la documentation ou avec DSPMSGD. Par exemple, le code -204 correspond à un objet introuvable.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(SYSTOOLS.SQLCODE_INFO(-204))

Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :

MESSAGE_ID Identifiant du message MESSAGE_TEXT Texte du message MESSAGE_SECOND_LEVEL_TEXT Texte de second niveau du message
SQL0204 Description de l'objet Description de l'objet

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Renvoyer les informations du message associé au SQLCODE -204.

-- Description: Return the message information for SQLCODE -204. 
   SELECT * FROM TABLE(SYSTOOLS.SQLCODE_INFO(-204));

Paramètres

ParamètreTypePar défautSignification
P_SQLCODE INTEGER obligatoire Code SQL à décrire

Colonnes renvoyées (3)

Afficher les 3 colonnes
ColonneTypeSignification
MESSAGE_ID CHAR(7) Identifiant du message
MESSAGE_TEXT GRAPHIC VARYING Texte du message
MESSAGE_SECOND_LEVEL_TEXT GRAPHIC VARYING Texte de second niveau du message