Examiner et comprendre les résultats de l'évaluation

Cette page explique comment examiner l'évaluation des éléments découverts et analyser les fichiers sources de l'application à l'aide de l'IA générative.

Les résultats de l'évaluation vous fournissent des informations telles que les lignes de code et le nombre d'appels trouvés dans l'application, ce qui vous aide à planifier votre migration. L'analyse vous fournit également un résumé du programme, ce qui vous aide à comprendre sa sémantique.

Avant de commencer

Examiner les résultats de l'évaluation de l'application

Pour ouvrir une évaluation et examiner les résultats, procédez comme suit :

  1. Ouvrez Mainframe Assessment Tool dans un navigateur Web.
  2. Dans le menu de navigation, cliquez sur Assessments (Évaluations).
  3. Sur la page Assessments (Évaluations), pour ouvrir une évaluation spécifique, cliquez sur la flèche d'expansion .

Le tableau de bord de l'évaluation s'affiche et comprend les pages suivantes :

Découvrir et analyser le code source

La page Discovery (Découverte) fournit un aperçu de l'analyse du code source de l'application que vous avez importée pour l'évaluation.

Pour découvrir et analyser votre code source, procédez comme suit :

  1. Cliquez sur Discovery (Découverte).

  2. Pour sélectionner un type de rapport, dans la liste Report type (Type de rapport), sélectionnez le type de rapport que vous souhaitez afficher.

    Le tableau suivant répertorie les différents types de rapports et leur description :

    Type de rapport Description Détails
    Inventory (Inventaire) Fournit des informations sur le nombre de fichiers, de lignes de code et de types de programmes, y compris les fichiers de configuration du planificateur (BMC Control-M).
    • Count by file type (Nombre par type de fichier) : nombre de fichiers par langue.
    • Lines of code by file type (Lignes de code par type de fichier) : nombre de lignes de code par type de fichier.
    • Actual vs commented lines of code (Lignes de code réelles par rapport aux lignes de code commentées) : nombre de lignes de code par rapport au nombre de lignes de commentaires.
    • Category - batch/online (Catégorie – lot/en ligne) : nombre de programmes par lot par rapport aux programmes en ligne.
    • Total lines of code (Nombre total de lignes de code) : nombre total de lignes de code dans tous les fichiers inclus dans l'évaluation. Utilisez ces données pour comprendre la taille globale de la codebase.
    Module Types (Types de modules) Catégorise les modules en fonction de leurs relations d'appel, spécifiquement pour COBOL et JCL.
    • Modules called from COBOL programs (Modules appelés à partir de programmes COBOL) : nombre de modules appelés directement à partir du code source COBOL.
    • Modules called from JCL (Modules appelés à partir de JCL) : nombre de modules qui sont appelés directement dans vos fichiers JCL.
    • Top 5 COBOL module utilities (Cinq principaux utilitaires de module COBOL) : liste des utilitaires fréquemment utilisés par vos programmes COBOL.
    • Top 5 JCL module utilities (Cinq principaux utilitaires de module JCL) : liste des utilitaires fréquemment utilisés dans les jobs JCL.
    Complexity (Complexité) Pour les programmes COBOL, affiche la complexité du code source à l'aide de la complexité cyclomatique (métrique de McCabe).

    Les métriques de McCabe représentent le nombre de chemins d'exécution ou de points de décision dans le code source. Cette valeur qualitative vous aide à identifier les applications qui peuvent être plus ou moins faciles à moderniser.
    • Complexity table (Tableau de complexité) : répartition fichier par fichier des métriques de complexité calculées, telles que le nombre de complexité. Un nombre de complexité plus élevé suggère un programme plus complexe.
      • Simple : complexité < 100
      • Moyen : 100 <= complexité < 500
      • Complexe : 500 <= complexité < 1 000
      • Très complexe : 1 000 <= complexité
    • Complexity mapping (Mappage de la complexité) : représentation visuelle du tableau de complexité qui fournit une vue d'ensemble de la complexité de votre codebase.
    Call Dependency (Dépendance d'appel) Affiche le graphe d'appel de toutes les entités importées, y compris les appels COBOL dynamiques résolus et les appels extraits d'autres langages compatibles. La résolution des appels pour PL/I n'est compatible qu'avec les appels statiques. La taille des icônes est liée au nombre d'appels entrants et sortants.
    Driver Modules (Modules de pilote) Affiche les modules qui appellent de nombreux autres modules. La taille des icônes est liée au nombre d'appels entrants et sortants.
    Datasets (Ensembles de données) Fournit une vue détaillée de tous les ensembles de données impliqués dans l'évaluation.
    • Dataset Lineage (Lignée de l'ensemble de données) : indique comment chaque ensemble de données est utilisé dans différents jobs, étapes et programmes.
    • Champs de l'ensemble de données : liste tous les champs de chaque ensemble de données, ainsi que leurs types de données, leurs positions de début, leurs tailles, leurs indicateurs clés et d'autres propriétés.
    Databases (Bases de données) Répertorie les tables DB2 et les segments IMS utilisés dans l'évaluation. Détaille la lignée des données, les colonnes et les propriétés pour chaque segment et table.
    Orphan Programs (Programmes orphelins) Répertorie tous les programmes qui n'appellent pas une autre entité et qui ne sont pas appelés par une autre entité.
    • Program name (Nom du programme) : identifie le module de programme qui a été trouvé dans le code source importé, mais qui ne semble pas être appelé ni exécuté par une autre partie de l'application.
    • Original source file (Fichier source d'origine) : nom du fichier contenant le code source du nom de programme correspondant.
    Missing Modules (Modules manquants) Affiche les modules utilisés dans le code, mais qui n'ont pas été trouvés lors de l'analyse des entrées.
    • Missing from file (Manquant dans le fichier) : fichier source spécifique contenant une référence à un module ou à un composant qui n'a pas pu être trouvé dans les fichiers d'évaluation importés.
    • Nom du module manquant : nom du module ou du composant manquant dans les fichiers importés.
    • Missing module type (Type de module manquant) : type de composant manquant, ce qui permet de comprendre la nature de la dépendance. Par exemple, DATASET_SCHEMA, COPYBOOK, ou PROC.

    Utilisez cet onglet pour comprendre ce qui manquait et envisagez d'ajouter ces modules avant de réexécuter l'évaluation.
    Parse Issues (Problèmes d'analyse) Affiche toutes les erreurs rencontrées lors de l'analyse du code source.
    • Fichier source : nom du fichier spécifique de votre code source importé dans lequel l'analyseur a détecté un problème.
    • Severity (Gravité) : indique la gravité du problème d'analyse. Par exemple, Warning.
    • Issues (Problèmes) : fournit une description du problème détecté par l'analyseur de code.
    CICS Calls (Appels CICS) Affiche les appels CICS effectués à partir de chaque programme et leurs paramètres. Vous pouvez filtrer les résultats par commande, programme ou paramètre.
    JCL Job Connections (Connexions de job JCL) Affiche les dépendances entre les jobs JCL en fonction des ensembles de données partagés, des tables DB2 et des segments IMS.
    • Connected jobs based on a shared data source (Jobs connectés en fonction d'une source de données partagée) : affiche la connexion entre deux jobs si l'un écrit des données dans une source de données partagée et l'autre lit à partir de cette même source de données. Les jobs qui ne lisent qu'à partir de la même source de données ne sont pas connectés les uns aux autres.
    • Connected jobs based on a shared data source (tabular view) (Jobs connectés en fonction d'une source de données partagée (vue tabulaire)) : affiche les détails de la connexion entre les jobs.
    • Job dependencies from writers to readers (Dépendances de job des rédacteurs aux lecteurs) : affiche le job du rédacteur, le programme du rédacteur, la source de données, le programme du lecteur et le job du lecteur.
    JCL Substitution Params (Paramètres de substitution JCL) Affiche les valeurs résolues des paramètres JCL.
    • Job name (Nom du job) : identifie de manière unique un job JCL spécifique, un ensemble d'instructions pour le mainframe qui exécute un processus par lot.
    • Step Name (Nom de l'étape) : identifie une seule étape d'exécution dans un job JCL. Un job se compose d'une ou de plusieurs étapes. Chaque étape exécute généralement un programme ou une procédure spécifique.
    • Data definition name (Nom de la définition de données) : affiche le nom d'une instruction de définition de données dans une procédure JCL.
    • Data set name (Nom de l'ensemble de données) : identifie le nom d'un fichier ou d'un ensemble de données tel qu'il existe sur les volumes de stockage du mainframe.
    • Parameter Name (Nom du paramètre) : fait référence à un paramètre symbolique qui agit comme une variable dans une procédure JCL.
    • Parameter Value (Valeur du paramètre) : fait référence à la valeur attribuée à un paramètre symbolique dans une procédure JCL.
    Transactions (Transactions) Affiche les relations extraites entre les programmes, les transactions et écrans pour IMS et CICS.
    • Program (Programme) : nom d'un programme IMS ou CICS en ligne.
    • Transaction (Transaction) : code de transaction IMS ou CICS qui peut être utilisé pour planifier l'exécution du programme.
    • Screen (Écran) : nom de l'écran ou de la carte utilisé par le programme ou la transaction.
    Duplicate Entities (Entités en double) Répertorie les programmes qui ont le même ID de programme.
    • Name (Nom) : nom de l'un des programmes d'un ensemble de programmes ayant le même ID de programme.
    • Type (Type) : type de programme, par exemple COBOL ou JCL.
    • Source file (Fichier source) : fichier source contenant ce programme.
    • Additional source file: (Fichier source supplémentaire) : liste les autres fichiers sources qui contiennent des programmes ayant le même ID de programme.
    Migratable units (Unités migrables) Partitionne les éléments en unités de migration pour générer un plan de migration préliminaire.
    • Migratable units graph: (Graphique des unités migrables) : montre comment les unités de migration dépendent les unes des autres dans un diagramme de dépendances (DAG).
    • Migratable units list (Liste des unités migrables) : liste des unités migrables avec le nom des unités migrables, le nombre d'éléments et le nombre de lignes sources.

      • Vous pouvez également consulter le graphique des éléments et la liste des éléments et des types d'éléments associés à une unité migratable.

    • Assets graph (Graphique des éléments) : affiche les dépendances entre les éléments d'une unité migratable.
    • Liste des éléments : liste les éléments de l'unité migratable avec des colonnes pour le nom de l'unité migratable, le nom de l'élément, le type d'élément et les lignes de code (lignes sources).

Examiner les insights générés par l'IA pour vos domaines d'activité

La page Domains (Domaines) fournit des insights générés par l'IA pour les domaines d'activité associés à cette évaluation. Une évaluation peut comporter plusieurs domaines, autant que vous en avez spécifié lors de sa création. Chaque domaine possède son propre état, son propre résumé, sa propre logique métier, son propre flux de données et ses propres éléments associés. Les domaines vous aident à partitionner des parties de votre codebase comme appartenant à une fonction métier spécifique.

Cette fonctionnalité nécessite que vous activiez les insights par IA et que vous ajoutiez un domaine d'activité lorsque vous créez l'évaluation. Si cette page n'est pas disponible, créez une évaluation et activez les insights par IA.

Pour obtenir une description générée par l'IA des domaines d'activité de votre application, procédez comme suit :

  1. Cliquez sur Domains (Domaines).

    Une liste de domaines s'affiche, ainsi que l'état de chaque domaine.

  2. Pour afficher le résumé, la logique métier et le flux de données d'un domaine spécifique, cliquez sur Show more (Afficher plus).

    Vous voyez des descriptions détaillées générées par l'IA du domaine d'activité de votre application. Ces descriptions incluent l'objectif, la logique, le traitement des données, le flux de données et les dépendances des données.

  3. Pour rechercher un domaine spécifique, dans le champ Search (Rechercher), saisissez le nom du domaine.

  4. Facultatif : Pour afficher la liste des éléments associés à ce domaine, cliquez sur View assets (Afficher les éléments).

Images de domaine

La page Domains (Domaines) affiche également des images générées par l'IA représentant vos domaines d'activité. Chaque image de domaine est générée en fonction de la spécification du domaine pour représenter visuellement les fonctions et les systèmes décrits dans le domaine.

La génération d'images de domaine présente les exigences suivantes :

  • Utilisation du point de terminaison Vertex AI global.
  • Modèles d'IA compatibles : Gemini 3.5 Flash, Gemini 3.1 Pro (preview) et Gemini 3 Flash (preview). Mainframe Assessment Tool utilise l'image Gemini 3 Pro (preview) pour la génération d'images de domaine.

Examiner les insights générés par l'IA pour les éléments

La page Assets (Éléments) fournit un résumé, une logique détaillée et des suggestions de code pour un programme ou un job dans votre application mainframe. Vous pouvez également afficher l'état, le type, la langue et le mode d'exécution (par lot ou en ligne) de chaque élément.

Pour les éléments de configuration du planificateur, tels que BMC Control-M, Mainframe Assessment Tool fournit des insights générés par l'IA qui vous aident à visualiser le workflow du planificateur, y compris une liste des jobs planifiés, des chronologies pour les planifications quotidiennes, hebdomadaires ou mensuelles, et des graphes de dépendances montrant les relations entre les jobs. Ces données sont également disponibles dans les rapports HTML et JSON exportés.

La page Assets (Éléments) affiche une nouvelle entrée dans le tableau pour chaque élément découvert, indiquant son état d'évaluation.

  • Pending (En attente) : l'élément attend son tour pour l'analyse.
  • In Progress (En cours) : l'évaluation de l'élément est en cours.
  • Completed (Terminé) : l'analyse de l'élément est terminée.
  • Warning (Avertissement) : l'évaluation est terminée avec un avertissement non bloquant lors de la génération de code.

Pour affiner la sélection des éléments, appliquez des filtres dans le champ Filter. Sélectionnez un nom de propriété sur lequel filtrer et saisissez une valeur de propriété. Par exemple, pour filtrer tous les éléments en fonction de leur état d'évaluation, définissez le nom de la propriété sur Status et sélectionnez une valeur telle que Warning ou Completed.

Pour afficher les détails d'un élément, procédez comme suit :

  1. Dans le tableau All assets (Tous les éléments), cliquez sur le nom d'un élément.

    La page Summary (Résumé) s'affiche. Elle fournit un résumé de l'élément généré par l'IA, ainsi que le cas d'utilisation et l'analyse de l'interaction de l'utilisateur.

  2. Pour afficher la logique détaillée de l'élément, cliquez sur Detailed Logic (Logique détaillée).

    Pour les programmes COBOL et les jobs JCL, la page Detailed logic (Logique détaillée) fournit des détails précis au niveau du paragraphe et de la méthode sur l'élément, ainsi que des cas de test. Si le job JCL est référencé par une configuration de planificateur dans l'évaluation, cette page inclut également des informations sur les prérequis du job du planificateur, les jobs dépendants et les planifications d'exécution.

  3. Pour afficher les champs de sortie, cliquez sur Output fields (Champs de sortie).

    Pour les programmes COBOL, la page Output fields (Champs de sortie) fournit un résumé des champs de données spécifiques générés par un programme et leurs descriptions.

  4. Pour afficher les suggestions de code, cliquez sur Code suggestions (Suggestions de code).

    Pour les programmes COBOL, la page Code suggestions (Suggestions de code) fournit une suggestion de code générée par l'IA dans les langages de programmation que vous avez sélectionnés lors de la création de l'évaluation.

  5. Pour afficher l'écran BMS, cliquez sur BMS maps (Cartes BMS).

    Pour les éléments BMS, la page BMS maps (Cartes BMS) affiche l'écran de l'interface.

Demander à Gemini

Le volet de chat Ask Gemini (Demander à Gemini) vous permet d'explorer votre évaluation en langage naturel. Vous pouvez poser des questions sur le code source et la logique métier, interroger des données d'évaluation telles que le nombre de lignes ou les métriques de complexité, et générer des visualisations telles que des graphiques.

Pour utiliser Ask Gemini (Demander à Gemini), procédez comme suit :

  1. Cliquez sur l'icône l&#39;icône Demander à Gemini Ask Gemini (Demander à Gemini).

  2. Saisissez votre question et appuyez sur Entrée. Les réponses sont diffusées en temps réel.

  3. Pour démarrer une nouvelle conversation, cliquez sur New chat (Nouvelle discussion).

  4. Pour afficher ou reprendre des conversations précédentes, cliquez sur More > Show chat history.

  5. Pour supprimer une conversation, cliquez sur More (Plus) > Show chat history (Afficher l'historique des discussions), et puis cliquez sur delete la conversation que vous souhaitez supprimer.

  6. Pour passer à l'expérience de chat classique, cliquez sur More > Use classic chat. Pour revenir en arrière, cliquez sur More (Plus) > Use enhanced chat (Utiliser le chat amélioré).

Étape suivante