Utiliser les outils et groupes d'outils

Découvrez les outils et groupes d'outils disponibles dans IBM Bob Premium Package for Z.

Outils

Les outils sont des éléments de base de bas niveau, spécifiques à une fonction, qui alimentent les workflows de scan, d'analyse, de transformation, de validation, de refactorisation et de documentation. Ces outils interagissent directement avec le code source des programmes, les bases de données d'analyse et les artefacts de transformation pour fournir des résultats précis et reproductibles.

Les tableaux suivants listent les outils inclus dans IBM® Bob Premium Package for Z.

Scan du code source et analyse du flux de contrôle

OutilDescription
scan_programScanne un programme COBOL ou PL/I pour générer une base de données de métadonnées contenant l'utilisation des variables, les références aux instructions et la structure du programme. Il doit être appelé avant get_variables. Retourne le chemin de la base de données nécessaire pour les analyses de variables ultérieures.
get_control_flowCalcule les graphes de flux de contrôle à partir des métadonnées de la base de données.
get_paragraphsInterroge les informations de paragraphes depuis la base de données de métadonnées.
execute_sql_queryExécute des requêtes SQL générées par l'IA sur la base de données de métadonnées.

Gestion du dictionnaire de données

OutilDescription
get_variablesRetourne la liste des variables utilisées dans le programme scanné avec scan_program.
edit_data_dictionaryOuvre le fichier dictionnaire de données (DD.json) dans l'éditeur pour révision et modification par l'utilisateur. Permet aux utilisateurs d'ajouter des descriptions métier pour les variables avant de générer des explications.
sync_data_dictionarySynchronise ton dictionnaire de données local avec les entrées de la copie centrale stockée sur le serveur Z Understand.

Explication et expansion du code

OutilDescription
persona_profileDécrit le type d'explication préféré de l'utilisateur pour les explications de programmes (architecte, développeur ou métier).

Refactorisation et extraction de services

OutilDescription
refactorOutil interactif pour effectuer des opérations de refactorisation Z Understand et guider l'extraction de services.
submit_refactor_findingsTrouve des emplacements dans un programme candidats à l'extraction de code de service.

Découverte d'actifs à l'échelle du projet via GraphQL

OutilDescription
sign_in_to_z_understandSe connecte à Z Understand et retourne des informations sur le projet d'analyse connecté.
get_project_programsRécupère tous les programmes d'un projet (retourne le progId requis par d'autres outils).
get_project_variablesRécupère toutes les variables définies dans un programme spécifique (nécessite progId).
get_project_tablesRécupère toutes les tables définies dans un projet.
get_project_statement_typesRécupère tous les types d'instructions disponibles dans un projet.
get_project_paragraphTrouve le paragraphe qui contient une ligne d'instruction spécifique dans un programme.
get_project_variable_usage_paragraphsTrouve tous les paragraphes d'un programme où une variable spécifique est utilisée.
get_project_resource_usageRécupère les informations d'utilisation des ressources (tables, variables, includes, écrans, dataset).
get_project_inventoryRécupère des informations globales sur le nombre d'artefacts inclus dans le projet pour chaque type (programme COBOL, programme PL/I, tables SQL, tables IMS).
get_project_unused_paragraphs (3.0.20+)Récupère tous les paragraphes non utilisés (morts ou inaccessibles) dans un ou plusieurs programmes. Par exemple, lorsque tu entres le prompt "dis-moi les paragraphes non utilisés pour le programme X" dans le chat Bob, la réponse affiche tous les paragraphes non utilisés associés au programme spécifié. Lorsque tu entres "dis-moi les paragraphes non utilisés pour les programmes dont le nom contient 'EDIX'", la réponse affiche tous les paragraphes non utilisés de chaque programme dont le nom contient "EDIX".
get_project_unused_programs (3.0.20+)Récupère tous les programmes non utilisés (morts ou inaccessibles) dans un projet. Par exemple, lorsque tu entres le prompt "dis-moi les programmes non utilisés dans le projet" dans le chat Bob, la réponse affiche tous les programmes non utilisés pour le projet sélectionné sur la base des enregistrements de base de données disponibles.
execute_project_sql_query (3.1.0+)Exécute des requêtes SQL SELECT brutes contre la base de données complète de métadonnées du projet (programmes, paragraphes, variables, fichiers, curseurs, tables SQL, copybooks, transactions, jobs JCL, données de planification CA7).

Outils Z Open Editor et ZCodeScan

OutilDescription
zOpenEditor-architect
zopeneditor-cobol-get-program-control-flowRécupère les données de flux de contrôle parsées depuis le serveur de langage COBOL pour analyser la structure du programme et les chemins d'exécution.
zopeneditor-cobol-get-data-flowTrace le flux de données pour un élément de données COBOL spécifique et retourne une représentation graphique de la façon dont l'élément est modifié dans le programme.
zopeneditor-pli-get-program-control-flowRécupère les données de flux de contrôle parsées depuis le serveur de langage PL/I pour analyser la structure du programme et les chemins d'exécution.
zopeneditor-get-embedded-languagesDétecte les langages embarqués dans un fichier COBOL ou PL/I.
zOpenEditor-code
zcodescan-check-current-programExécute un IBM ZCodeScan sur le fichier programme COBOL ou PL/I actuellement ouvert dans l'éditeur. Le scan parse le programme et retourne des problèmes de style linter sur la qualité du programme.
zcodescan-check-list-of-local-programsExécute un IBM ZCodeScan sur les fichiers COBOL ou PL/I dans ton espace de travail local. Les fichiers sont identifiés par une liste de patterns de recherche glob qui définissent tous les programmes à scanner dans l'espace de travail de l'éditeur.
zopeneditor-cobol-format-fileFormate un fichier COBOL à l'aide du serveur de langage COBOL et d'un fichier Z Code Format.
zopeneditor-cobol-format-multiple-filesFormate plusieurs fichiers COBOL à l'aide du serveur de langage COBOL et d'un fichier Z Code Format.
zopeneditor-cobol-renumber-fileRenuméroté un fichier COBOL à l'aide du serveur de langage COBOL pour ajouter des numéros de séquence à chaque ligne du fichier.
zopeneditor-cobol-renumber-multiple-filesRenuméroté plusieurs fichiers COBOL dans l'espace de travail à l'aide du serveur de langage COBOL.
zopeneditor-cobol-unnumber-fileSupprime les numéros de séquence de chaque ligne d'un fichier COBOL à l'aide du serveur de langage COBOL.
zopeneditor-cobol-unnumber-multiple-filesSupprime les numéros de séquence de chaque ligne de plusieurs fichiers COBOL dans l'espace de travail à l'aide du serveur de langage COBOL.

Outils d'optimisation du code (3.1.0+)

OutilDescription
submit_optimize_findingsParse un rapport de recommandations et soumet chaque recommandation comme un Bob Finding sur le fichier COBOL concerné.

Groupes d'outils

Les groupes d'outils catégorisent les capacités en domaines logiques pour améliorer la découverte, le contrôle d'accès et la convivialité sur la plateforme. Chaque groupe représente un ensemble d'opérations liées, comme l'analyse de code et les intégrations, permettant aux utilisateurs et aux systèmes d'organiser et d'invoquer efficacement les fonctionnalités en fonction de l'intention.

CatégorieGroupe d'outilsDescriptionID
CoreCoreEnsemble d'outils de base requis pour les opérations principales.core
CoreHintFournit des suggestions contextuelles, des conseils ou des indices en ligne pour assister les utilisateurs.toolHint
Data & APIScanUtilisé pour scanner des bases de code, des ressources ou des environnements.scan
Data & APIData DictionaryPermet l'interaction avec les métadonnées, les définitions de schémas et les descriptions de données structurées.dataDictionary
Data & APIGraphQLGère la génération de requêtes GraphQL, l'exécution et les opérations de schéma.graphQl
Code IntelligenceAnalysisEffectue une analyse statique/dynamique pour des insights sur la qualité du code, les dépendances et les problèmes.analysis
Code IntelligenceExplainGénère des explications de la logique du code, des fonctions et des workflows.explain
Code ModificationRefactorSupporte la restructuration du code sans changer la fonctionnalité.refactor
IntegrationszOpenEditor ArchitectOutillage axé sur l'architecture pour les workflows zOpenEditor.zOpenEditor-architect
IntegrationszOpenEditor CodeOutillage au niveau du code dans zOpenEditor.zOpenEditor-code
IntegrationszOpenDebug Code (3.1.0+)Outillage au niveau du code dans zOpenDebug.zOpenDebug-code
Comment trouvez-vous ce sujet ?