Créer et modifier des évaluations

Cette page explique comment importer vos applications dans Mainframe Assessment Tool et évaluer les éléments que Mainframe Assessment Tool détecte dans la base de code importée.

Vous pouvez effectuer une détection des éléments vous-même ou demander l'aide d'un ingénieur client Google.

Avant de commencer

Pour préparer votre évaluation, assurez-vous d'avoir rempli les conditions préalables suivantes :

Importer les fichiers de votre application mainframe dans Mainframe Assessment Tool

Pour importer les fichiers de l'application dans Mainframe Assessment Tool, procédez comme suit :

  1. Créez un fichier ZIP contenant toutes les applications que vous souhaitez migrer.

    Mainframe Assessment Tool n'accepte que les fichiers ZIP d'une taille maximale de 400 Mo. Si la taille de votre fichier ZIP d'application est supérieure à 400 Mo, envisagez de le scinder en plusieurs fichiers ZIP plus petits en fonction des domaines d'activité et d'importer un fichier ZIP pour chaque domaine.

    Si les applications contiennent des références à des artefacts externes tels que des programmes ou des tables, nous vous recommandons d'inclure également ces dépendances. Si disponible, fournissez le code source des types suivants :

    • Programmes COBOL (cob et cbl)
    • Copybooks COBOL (inc et cpy)
    • Programmes Easytrieve (ezt)
    • Programmes HLASM (asm)
    • Jobs JCL (jcl)
    • Procédures JCL (proc)
    • Inclusions JCL
    • Données de carte JCL (ctl)
    • Programmes PL/I (pli et pl1)
    • Programmes RPG/RPGLE (rpg et rpgle)
    • Fichiers d'inclusion RPG/RPGLE (rpginc et rpgleinc)
    • Configurations du planificateur pour BMC Control-M

    N'incluez pas de fichiers binaires ni d'autres fichiers non sources dans le fichier ZIP.

  2. Pour importer le fichier ZIP dans Mainframe Assessment Tool, procédez comme suit :

    1. Pour ouvrir Mainframe Assessment Tool sur votre ordinateur local, ouvrez une fenêtre de navigateur Web et accédez à http://localhost:PORT.

      Remplacez PORT par le numéro de port que vous avez utilisé sur votre ordinateur local pour la connexion tunnelisée à Mainframe Assessment Tool.

    2. Sur la page Accueil, cliquez sur Créer une évaluation.

    3. Dans le champ "Nom", saisissez un nom.

    4. Facultatif : dans le champ "Description", saisissez une description de l'évaluation.

    5. Pour importer un fichier ZIP, cliquez sur Sélectionner un fichier. L'explorateur de fichiers s'ouvre. Sélectionnez le fichier ZIP que vous souhaitez importer. Vous ne pouvez importer qu'un seul fichier à la fois.

    6. Cliquez sur Suivant.

  3. Pour configurer les insights générés par l'IA, procédez comme suit :

    1. Pour générer des résumés au niveau du paragraphe pour le code COBOL, sélectionnez Résumés détaillés. Cette option est sélectionnée par défaut.

    2. Pour générer des scénarios de test pour les spécifications d'évaluation générées par Gemini, sélectionnez Scénarios de test. Cette option n'est pas sélectionnée par défaut.

    3. Pour générer des exemples de code qui traduisent les langages mainframe en Python, Java, C# et SQL, sélectionnez Suggestions de code. Cette option n'est pas sélectionnée par défaut.

    4. Dans le champ Conseils sur la pile technologique, saisissez du texte qui aide Gemini à générer du code pour une pile technologique spécifique. Par exemple, saisissez Spring Boot and MySQL.

    5. Cliquez sur Suivant.

  4. Pour configurer les modèles Gemini et le niveau de qualité de l'évaluation, configurez l'étape Modèle et qualité, puis cliquez sur Suivant.

    Par défaut, Mainframe Assessment Tool utilise le niveau de qualité Équilibré recommandé. Pour en savoir plus sur les niveaux de qualité, le choix d'un modèle spécifique et la conservation des données dans votre région, consultez Choisir des modèles et une qualité.

  5. Facultatif : pour ajouter un ou plusieurs domaines représentant une zone de fonctionnalité distincte, cliquez sur Ajouter un domaine.

    Les domaines vous permettent de filtrer et d'examiner les résultats en fonction de contextes spécifiques une fois l'évaluation terminée.

  6. Cliquez sur Suivant.

  7. Cliquez sur Créer une évaluation.

Une fois le fichier ZIP importé, Mainframe Assessment Tool décompresse et traite le code source. La page Évaluations affiche une nouvelle entrée dans le tableau pour chaque élément détecté, indiquant son état d'évaluation.

  • En attente : l'évaluation attend son tour.
  • En cours : l'analyse est en cours.
  • Analysé : l'évaluation est terminée.
  • Échec : l'évaluation n'a pas abouti.

Si des erreurs s'affichent après l'importation de votre fichier, vous pouvez consulter le message d'erreur directement dans Mainframe Assessment Tool.

Pour afficher plus de détails sur la progression de l'évaluation d'un élément, cliquez sur l'ID de référence à côté de celui-ci dans le tableau. Une page s'ouvre, affichant toutes les étapes ainsi que leur état.

Choisir des modèles et une qualité

Configurez les modèles Gemini pour une évaluation lors de la création ou de la modification d'une évaluation. Ces paramètres ne s'appliquent qu'à cette évaluation.

Par défaut, Mainframe Assessment Tool optimise les modèles pour chaque étape d'évaluation en fonction du niveau de qualité sélectionné. L'outil achemine les étapes de raisonnement complexes vers des modèles plus lourds et les étapes plus simples vers des modèles plus légers.

Sélectionner un niveau de qualité

Dans le champ Optimiser pour, sélectionnez l'un des niveaux de qualité suivants :

  • Équilibré (recommandé) : équilibre la vitesse et la profondeur pour la plupart des évaluations. Il s'agit du niveau par défaut.
  • Rapide : renvoie les résultats les plus rapides en utilisant des modèles plus légers.
  • Étendu : maximise la profondeur d'analyse en utilisant des modèles plus lourds.

Chaque niveau de qualité répertorie les modèles Gemini utilisés pour chaque étape.

Spécifier un seul modèle

Pour exécuter toutes les étapes d'évaluation sur un seul modèle plutôt que d'optimiser par niveau, sélectionnez Utiliser un modèle spécifique à la place , puis choisissez un modèle dans la liste. Chaque modèle est libellé soit Disponibilité générale ou Preview.

Mainframe Assessment Tool est compatible avec toutes les zones des régions Agent Platform disponibles.

Appliquer la résidence des données

Par défaut, Mainframe Assessment Tool achemine les appels de modèle vers l'emplacement optimal pour les modèles sélectionnés, y compris la région d'évaluation, une région multirégionale ou le point de terminaison global Agent Platform.

Pour limiter les appels de modèle à la région d'évaluation et à sa région multirégionale associée, activez l'option Conserver les données dans ma région. Lorsque ce paramètre est activé, Mainframe Assessment Tool effectue les actions suivantes :

  • Désactive les niveaux de qualité qui nécessitent un modèle Gemini non disponible dans la région d'évaluation. Ces niveaux sont libellés Non disponible dans cette région.
  • Masque les modèles de la liste de modèles spécifiques qui ne sont pas disponibles dans la région d'évaluation.

Si aucun modèle compatible n'est disponible dans la région d'évaluation, l'évaluation ne peut pas s'exécuter avec l'option Conserver les données dans ma région activée. Pour poursuivre l'évaluation, désactivez l'option Conserver les données dans ma région afin d'autoriser les appels de modèle en dehors de la région.

Ajouter des fichiers à une évaluation existante

Une fois que vous avez créé une évaluation, vous pouvez y ajouter d'autres fichiers ZIP. Les fichiers du nouveau fichier ZIP sont fusionnés avec les fichiers existants dans l'évaluation. Si vous souhaitez remplacer des fichiers existants, le nouveau fichier ZIP doit inclure les fichiers que vous remplacez avec exactement la même structure de chemin d'accès.

Pour ajouter des fichiers à une évaluation existante, procédez comme suit :

  1. Ouvrez Mainframe Assessment Tool dans un navigateur Web.
  2. Dans le menu de navigation, cliquez sur Évaluations.
  3. Sur la page Évaluations, recherchez l'évaluation que vous souhaitez modifier, puis cliquez sur Ouvrir l'évaluation.
  4. Cliquez sur Ajouter un fichier.
  5. Cliquez sur Sélectionner un fichier, puis sélectionnez le fichier ZIP que vous souhaitez importer. Vous ne pouvez importer qu'un seul fichier à la fois.
  6. Cliquez sur Ajouter.

Une fois les fichiers importés, Mainframe Assessment Tool redémarre l'analyse. Si vous remplacez des fichiers, ils sont entièrement réévalués, et toute analyse existante pour ces fichiers peut changer. Pendant le retraitement, un indicateur Obsolète s'affiche à côté des fichiers en cours de retraitement.

Mettre à jour les détails et les paramètres de l'évaluation

Une fois que vous avez créé une évaluation, vous pouvez modifier son nom et sa description, ainsi que les paramètres des insights générés par l'IA.

Pour modifier les détails ou les paramètres de l'évaluation, procédez comme suit :

  1. Ouvrez Mainframe Assessment Tool dans un navigateur Web.
  2. Dans le menu de navigation, cliquez sur Évaluations.
  3. Sur la page Évaluations, recherchez l'évaluation que vous souhaitez modifier, puis cliquez sur Ouvrir l'évaluation.
  4. Cliquez sur settingsModifier les paramètres de l'évaluation.
  5. Facultatif : à l'étape Détails de l'évaluation , modifiez le nom et la description, puis cliquez sur Suivant.
  6. Facultatif : à l'étape Paramètres d'IA, modifiez les paramètres d'IA si nécessaire, puis cliquez sur Suivant.
  7. Facultatif : à l'étape Modèle et qualité, configurez les modèles ou le niveau de qualité, puis cliquez sur Suivant. Pour en savoir plus, consultez Choisir des modèles et une qualité.
  8. À l'étape Domaines, cliquez sur Suivant. Vous ne pouvez pas modifier les domaines après avoir créé une évaluation.
  9. Cliquez sur Modifier l'évaluation.

Une fois les paramètres modifiés, Mainframe Assessment Tool redémarre l'analyse.

Étape suivante