Guide DB2

Utiliser DB2 for z/OS dans Assistant z/OS

Guide pratique pour rechercher un SQLCODE, comprendre son SQLSTATE, exploiter les Reason Codes, lire la documentation IBM et utiliser l’analyse IA comme aide au diagnostic.

DB2 for z/OS SQLCODE · SQLSTATE · Reason Codes Version 1.0

1. Présentation du module DB2

Le module DB2 centralise les références DB2 for z/OS disponibles dans la base documentaire d’Assistant z/OS. Il permet d’accéder rapidement aux SQLCODE, SQLSTATE et Reason Codes, puis de consulter les informations associées.

SQLCODECode de retour principal produit par DB2 à l’issue d’une instruction SQL.

SQLSTATECode standardisé à cinq caractères qui complète l’interprétation du SQLCODE.

Reason CodeValeur complémentaire permettant de préciser la cause d’un incident.

2. Rechercher un SQLCODE

Depuis le portail ou depuis le module DB2, saisissez directement le code recherché.

-904 -911 -922 +100

Saisir le code

Entrez le SQLCODE dans la zone de recherche.

Ouvrir la fiche

Assistant z/OS affiche la référence correspondante lorsqu’elle est présente dans le corpus.

Lire le contexte

Consultez le SQLSTATE, le message, l’explication et les éventuels paramètres associés.

La recherche universelle permet également de retrouver un SQLCODE sans sélectionner DB2 au préalable.

3. Comprendre SQLCODE et SQLSTATE

Le SQLCODE identifie le résultat de l’instruction SQL. Le SQLSTATE fournit une classification complémentaire. Lorsqu’ils sont tous deux disponibles, ils doivent être lus ensemble.

Élément	Rôle	Exemple
SQLCODE	Identifie le résultat ou l’erreur DB2.	`-904`
SQLSTATE	Classe la nature de la condition SQL.	`57011`
Reason Code	Précise la cause lorsqu’un message en fournit un.	`00E7000E`

4. Utiliser les Reason Codes

Certains messages DB2 contiennent un Reason Code qui affine fortement le diagnostic. Assistant z/OS permet de rechercher directement cette valeur.

00E7000E

Selon le message, le Reason Code peut être accompagné d’un type de ressource et d’un nom de ressource. Ces informations doivent être conservées dans l’analyse.

Attention : un même SQLCODE peut correspondre à plusieurs situations. Le Reason Code et les paramètres du message permettent de les distinguer.

5. Lire une fiche DB2

Une fiche DB2 peut présenter plusieurs sections issues de la documentation structurée :

Message IBM : texte principal de la référence.
Explication : contexte et signification.
Réaction du système : comportement de DB2 après l’erreur.
Action du programmeur : vérifications ou actions recommandées.
Références : éléments documentaires complémentaires.

Trois niveaux de lecture

IBM OriginalTexte source du corpus IBM indexé.

IBM FrançaisTraduction française destinée à faciliter la compréhension.

Analyse IASynthèse complémentaire orientée explication et diagnostic.

Principe : la documentation IBM reste la référence de contrôle. La traduction et l’analyse IA sont des couches d’assistance distinctes.

6. Exemple : SQLCODE -904

SQLCODE -904 · SQLSTATE 57011

Dans Assistant z/OS, la fiche -904 correspond à une exécution impossible parce qu’une ressource nécessaire n’est pas disponible. Pour préciser la cause, il faut examiner les informations fournies avec le message.

Reason Code : raison détaillée de l’indisponibilité.
Resource Type : type de ressource concerné.
Resource Name : nom de la ressource identifiée.

Le bon réflexe n’est pas seulement de retenir « -904 = ressource indisponible », mais d’identifier précisément la ressource concernée et la raison de son indisponibilité.

7. Utiliser l’Analyse IA

L’Analyse IA exploite le contexte documentaire disponible pour produire une lecture structurée : résumé, explication, causes probables, diagnostic et éléments de résolution.

Une analyse déjà générée peut être chargée depuis le cache. Selon l’écran, une régénération peut être proposée.

Important : l’Analyse IA est une assistance. Toute action doit être vérifiée par rapport à la documentation IBM et aux procédures de votre environnement avant intervention en production.

8. Enregistrer une référence dans les Favoris

Depuis une fiche DB2, utilisez Ajouter aux favoris pour mémoriser la référence. Les favoris sont rattachés à l’utilisateur connecté.

Un nouvel utilisateur commence avec une liste vide.
Un utilisateur connu retrouve ses références enregistrées.
Une fiche peut être rouverte directement depuis la page Favoris.

9. Méthode de diagnostic recommandée

Identifier le SQLCODE exact.
Lire le SQLSTATE associé.
Relever le Reason Code et les paramètres éventuels.
Consulter d’abord IBM Original.
Utiliser IBM Français si nécessaire pour faciliter la compréhension.
Consulter Analyse IA pour synthétiser et orienter les vérifications.
Valider les actions envisagées avec les procédures de l’environnement.

10. Source et traçabilité

Assistant z/OS sépare volontairement la source documentaire, la traduction et l’analyse IA. Cette séparation permet de distinguer ce qui provient du corpus IBM de ce qui relève d’une aide à l’interprétation.

Point de contrôle : pour une décision technique, revenir systématiquement à la référence IBM affichée et tenir compte de la version du produit, des paramètres du message et du contexte opérationnel.

11. Bonnes pratiques DB2

Rechercher le code exact lorsqu’il est disponible.
Ne pas interpréter un SQLCODE isolément si un Reason Code est fourni.
Conserver les paramètres du message dans le diagnostic.
Commencer par la documentation IBM avant l’analyse IA.
Utiliser les Favoris pour les références récurrentes.
Vérifier les actions recommandées avant toute intervention en production.