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

Cette page explique comment examiner l'évaluation des composants 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 détails tels 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 la demande

Pour ouvrir une évaluation et examiner les résultats :

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

Le tableau de bord d'évaluation s'affiche. Il comprend les pages suivantes :

Découvrir et analyser le code source

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

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

  1. Cliquez sur Découverte.

  2. Pour sélectionner un type de rapport, dans la liste 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
    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).
    • Nombre par type de fichier : nombre de fichiers par langue.
    • Lignes de code par type de fichier : nombre de lignes de code par type de fichier.
    • Nombre réel de lignes de code par rapport au nombre de lignes commentées : nombre de lignes de code comparé au nombre de lignes de commentaires.
    • Catégorie : lot/en ligne : nombre de programmes par lot par rapport aux programmes en ligne.
    • 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.
    Types de modules Catégorise les modules en fonction de leurs relations d'appel, en particulier pour COBOL et JCL.
    • Modules appelés à partir de programmes COBOL : nombre de modules appelés directement à partir du code source COBOL.
    • Modules appelés depuis JCL : nombre de modules appelés directement dans vos fichiers JCL.
    • Top 5 des utilitaires de module COBOL : liste des utilitaires fréquemment utilisés par vos programmes COBOL.
    • Cinq utilitaires de module JCL les plus utilisés : liste des utilitaires fréquemment utilisés dans les jobs JCL.
    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.
    • Tableau de complexité : répartition des métriques de complexité calculées, telles que le nombre de complexités, pour chaque fichier. Un nombre de complexité plus élevé suggère un programme plus complexe.
      • Simple : complexité < 100
      • Moyenne : 100 <= complexité < 500
      • Complexe : 500 <= complexité < 1 000
      • Très complexe : 1 000 <= complexité
    • Mappage de la complexité : représentation visuelle du tableau de complexité qui fournit un aperçu de la complexité de votre codebase.
    Dépendance d'appel Affiche le graphique d'appel de toutes les entités importées. La taille des icônes est liée au nombre d'appels entrants et sortants.
    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.
    Ensembles de données Fournit une vue détaillée de tous les ensembles de données impliqués dans l'évaluation.
    • 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.
    Bases de données Liste les tables DB2 et les segments IMS utilisés dans l'évaluation. Détaille la lignée de données, les colonnes et les propriétés de chaque segment et tableau.
    Programmes orphelins Liste tous les programmes qui n'appellent pas d'autre entité et qui ne sont pas appelés par une autre entité.
    • 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.
    • Fichier source d'origine : nom du fichier contenant le code source du nom de programme correspondant.
    Modules manquants Affiche les modules utilisés dans le code, mais introuvables lors de l'analyse des entrées.
    • Absent du fichier : fichier source spécifique contenant une référence à un module ou un composant introuvable dans les fichiers d'évaluation importés.
    • Nom du module manquant : nom du module ou du composant manquant dans les fichiers importés.
    • Type de module manquant : type du 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 relancer l'évaluation.
    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.
    • Gravité : indique la gravité du problème d'analyse. Exemple :Warning
    • Problèmes : fournit une description du problème détecté par l'analyseur de code.
    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 Affiche les dépendances entre les jobs JCL en fonction des ensembles de données, des tables DB2 et des segments IMS partagés.
    • Jobs connectés basés sur 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 les données de cette même source de données. Les jobs qui ne font que lire les données de la même source de données ne sont pas connectés les uns aux autres.
    • Jobs connectés basés sur une source de données partagée (vue tabulaire) : affiche les détails de la connexion entre les jobs.
    • Dépendances des jobs, 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.
    Paramètres de substitution JCL Affiche les valeurs résolues des paramètres JCL.
    • 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.
    • 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.
    • 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.
    • 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 sert de variable dans une procédure JCL.
    • Valeur du paramètre : valeur attribuée à un paramètre symbolique dans une procédure JCL.
    Transactions Affiche les relations extraites entre les programmes, les transactions et les écrans pour IMS et CICS.
    • Programme : nom d'un programme IMS ou CICS en ligne.
    • Transaction : code de transaction IMS ou CICS pouvant être utilisé pour planifier l'exécution du programme.
    • Écran : nom de l'écran ou de la carte utilisés par le programme ou la transaction.
    Entités en double Liste les programmes qui ont le même ID de programme.
    • Nom : nom de l'un des programmes d'un ensemble de programmes ayant le même ID de programme.
    • Type : type de programme (par exemple, COBOL ou JCL).
    • Fichier source : fichier source contenant ce programme.
    • Fichier source supplémentaire : liste les autres fichiers sources contenant des programmes avec le même ID de programme.
    Unités migrables Partitionne les composants en unités de migration pour générer un plan de migration préliminaire.
    • Graphique des unités migrables : indique comment les unités de migration dépendent les unes des autres dans un diagramme de dépendances (DAG).
    • Liste des unités migrables : liste des unités migrables avec le nom des unités migrables, le nombre d'assets et le nombre de lignes sources.

      • Vous pouvez également consulter le graphique des composants, ainsi que la liste des composants et des types de composants associés à une unité migratable.

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

Obtenir des insights générés par IA pour votre domaine d'activité

La page 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, jusqu'au nombre que vous avez spécifié lors de sa création. Chaque domaine possède son propre état, son propre récapitulatif, sa propre logique métier, son propre flux de données et ses propres composants associés. Les domaines vous aident à partitionner des parties de votre codebase comme appartenant à une fonction métier spécifique.

Pour utiliser cette fonctionnalité, vous devez activer les insights d'IA et ajouter 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 d'IA.

Pour obtenir une description générée par 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 chacun d'eux.

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

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

  3. Pour rechercher un domaine spécifique, saisissez son nom dans le champ Rechercher.

  4. Facultatif : Pour afficher la liste des composants associés à ce domaine, cliquez sur Afficher les composants.

Images de domaine

La page 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 est soumise aux exigences suivantes :

  • Utilisation du point de terminaison Vertex AI global.
  • Modèles d'IA compatibles : default et gemini 3 pro.

Afficher les insights générés par IA pour les composants

La page Composants fournit un récapitulatif, 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 composant.

Pour les composants de configuration du planificateur, tels que BMC Control-M, l'outil Mainframe Assessment fournit des insights générés par l'IA qui vous aident à visualiser le workflow du planificateur, y compris une liste des tâches planifiées, des chronologies pour les plannings quotidiens, hebdomadaires ou mensuels, et des graphiques de dépendances montrant les relations entre les tâches. Ces données sont également disponibles dans les rapports HTML et JSON exportés.

La page Composants affiche une nouvelle entrée dans le tableau pour chaque composant détecté, avec son état d'évaluation.

  • En attente : l'élément attend son tour pour être analysé.
  • En cours : l'évaluation de l'élément est en cours.
  • Terminée : l'analyse des composants est terminée.
  • Avertissement : l'évaluation est terminée et un avertissement non bloquant s'affiche lors de la génération du code.

Pour affiner la sélection de composants, appliquez des filtres dans le champ Filter. Sélectionnez un nom de propriété sur lequel filtrer les données, puis saisissez une valeur de propriété. Par exemple, pour filtrer tous les composants 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 composant, procédez comme suit :

  1. Dans le tableau Tous les composants, cliquez sur le nom d'un composant.

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

  2. Pour afficher la logique détaillée concernant le composant, cliquez sur Logique détaillée.

    Pour les programmes COBOL et les jobs JCL, la page Logique détaillée fournit des informations précises au niveau des paragraphes et des méthodes sur le composant, 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 ses prérequis de job de planificateur, ses jobs dépendants et ses plannings d'exécution.

  3. Pour afficher les champs de sortie, cliquez sur Champs de sortie.

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

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

    Pour les programmes COBOL, la page 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 Cartes BMS.

    Pour les composants BMS, la page Cartes BMS affiche l'écran de l'interface.

Demander à Gemini

Si vous avez besoin d'aide pour comprendre le contenu d'une page, vous pouvez demander de l'aide à Gemini.

Pour demander de l'aide à Gemini, procédez comme suit :

  1. Sur la page pour laquelle vous avez besoin d'aide, cliquez sur l'icône l&#39;icône Demander à Gemini Demander à Gemini.

    Le volet Demander à Gemini s'affiche. Vous pouvez poser des questions sur l'évaluation. Par exemple, vous pouvez poser des questions sur l'objectif commercial d'un programme spécifique, comme which program is responsible for calculating the claim rate?.

  2. Pour effacer l'historique des discussions, cliquez sur l'icône  Plus, puis sur Effacer le chat.

Étapes suivantes