Assistant z/OS — Édition Entreprise
Retour aux manuels
Guide Assistant IA

Utiliser l’Assistant IA pour accélérer le diagnostic

L’Assistant IA complète la documentation IBM en proposant une lecture structurée : résumé, explication, causes probables, diagnostic et pistes de résolution. Il reste une couche d’assistance distincte de la source documentaire IBM.

Analyse IA DB2 · CICS · MQ · IMS · JES2 · RACF · USS Version 1.0

1. Présentation

L’Assistant IA est une couche complémentaire à la documentation technique. Il ne remplace pas IBM Original ou IBM Français : il aide à transformer une fiche documentaire en synthèse plus directement exploitable pour le diagnostic.

ComprendreReformuler un message technique en langage plus directement exploitable.
DiagnostiquerFaire ressortir les causes probables et les vérifications utiles.
RésoudreStructurer des pistes d’action à vérifier avant toute intervention.

2. Accéder à l’Analyse IA

Depuis une fiche DB2, CICS, MQ, IMS, JES2, RACF ou USS, utilisez l’onglet ou le bouton Analyse IA. L’analyse est produite à partir des informations documentaires disponibles pour la référence consultée.

1
Ouvrir une fiche

Recherchez un SQLCODE ou une référence DB2, CICS, MQ, IMS, JES2, RACF ou USS.

2
Lire la référence IBM

Consultez d’abord le texte IBM Original et, si nécessaire, IBM Français.

3
Ouvrir Analyse IA

Utilisez ensuite la synthèse IA comme aide à l’interprétation.

3. Structure d’une analyse IA

Selon la référence et les informations disponibles, une analyse peut être organisée en plusieurs blocs :

  • Résumé : synthèse courte de la condition rencontrée.
  • Explication : reformulation plus accessible du message.
  • Causes probables : situations susceptibles d’expliquer l’incident.
  • Diagnostic : vérifications à effectuer pour préciser la cause.
  • Résolution : pistes d’action à examiner.

4. Résumé et explication

Le résumé permet de comprendre rapidement le sens général de la fiche. L’explication développe ensuite les éléments essentiels du message et les relie au contexte technique disponible.

Bon usage : utiliser le résumé pour s’orienter rapidement, puis revenir au texte IBM pour vérifier les détails précis.

5. Causes probables

La section Causes probables regroupe plusieurs scénarios susceptibles d’expliquer l’erreur. Il s’agit d’hypothèses à confronter aux informations réelles de l’environnement.

  • Paramètres du message.
  • Reason Code ou SQLSTATE lorsqu’ils existent.
  • État d’une ressource.
  • Contexte applicatif ou transactionnel.
  • Informations disponibles dans les journaux système.
Attention : une cause probable n’est pas une cause prouvée. Elle doit être confirmée par le diagnostic.

6. Diagnostic

La partie Diagnostic sert à organiser les vérifications techniques. Elle peut aider à déterminer quelles informations examiner avant de prendre une décision.

  1. Relire le code ou le message exact.
  2. Conserver tous les paramètres associés.
  3. Comparer avec le texte IBM Original.
  4. Vérifier les Reason Codes, SQLSTATE ou messages associés.
  5. Examiner les journaux et le contexte opérationnel si nécessaire.

7. Résolution

Les éléments de résolution proposent une démarche possible à partir de la documentation et de l’analyse du message. Ils doivent être considérés comme des pistes à valider.

Avant toute action : vérifier la documentation IBM, la version du produit et les procédures de votre environnement. Une analyse IA ne doit pas déclencher automatiquement une action de production.

8. Cache IA

Lorsqu’une analyse a déjà été générée pour une référence, Assistant z/OS peut la conserver en cache afin d’éviter une nouvelle génération inutile.

Lorsqu’une analyse provient du cache, l’interface peut l’indiquer explicitement. Cela permet de savoir que le contenu affiché a déjà été produit lors d’une consultation précédente.

Avantage : le cache améliore la rapidité d’affichage et limite les générations répétées pour une même référence.

9. Régénérer une analyse

Lorsqu’un bouton Régénérer l’analyse est disponible, il permet de demander une nouvelle synthèse au lieu de réutiliser celle conservée en cache.

Une régénération peut produire une formulation différente, mais elle ne change pas la source documentaire de référence.

10. Sources, traçabilité et validation

Assistant z/OS sépare volontairement les trois niveaux de lecture afin de préserver la traçabilité de l’information.

IBM OriginalSource documentaire de référence présente dans le corpus indexé.
IBM FrançaisTraduction destinée à faciliter la compréhension du texte technique.
Analyse IAInterprétation complémentaire construite à partir du contexte disponible.
Règle de validation : lorsque l’analyse IA propose une cause ou une action, la décision technique doit être vérifiée par rapport à la documentation IBM et au contexte réel de l’incident.

11. Limites de l’Assistant IA

  • L’IA ne connaît pas automatiquement l’état réel de votre environnement z/OS.
  • Elle ne voit pas les journaux ou paramètres qui ne lui sont pas fournis.
  • Elle peut proposer plusieurs causes possibles sans pouvoir déterminer seule laquelle est la bonne.
  • Une réponse peut être incomplète si la documentation disponible est elle-même insuffisante pour le cas rencontré.
  • Elle ne remplace pas l’expertise d’exploitation, système ou applicative.

12. Bonnes pratiques

  • Commencer par IBM Original avant d’utiliser l’IA.
  • Lire IBM Français lorsque la traduction facilite la compréhension.
  • Utiliser l’IA pour structurer le diagnostic, pas pour remplacer la source.
  • Conserver les Reason Codes, SQLSTATE et paramètres de messages.
  • Comparer les hypothèses IA aux journaux et au contexte réel.
  • Vérifier toute action avant intervention en production.
  • Régénérer une analyse uniquement lorsqu’une nouvelle synthèse est utile.