Tools und Tool-Gruppen verwenden

Erfahre mehr über die Tools und Tool-Gruppen im IBM Bob Premium Package for Z.

Tools

Tools sind funktionsspezifische Bausteine auf unterer Ebene, die Scan-, Analyse-, Transformations-, Validierungs-, Refactoring- und Dokumentations-Workflows antreiben. Diese Tools interagieren direkt mit Programmquellcode, Analysedatenbanken und Transformationsartefakten, um präzise, wiederholbare Ergebnisse zu liefern.

Die folgenden Tabellen listen die im IBM® Bob Premium Package for Z enthaltenen Tools auf.

Quellcode-Scanning und Kontrollflussanalyse

ToolBeschreibung
scan_programScannt ein COBOL- oder PL/I-Programm, um eine Metadaten-Datenbank zu generieren, die Variablennutzung, Anweisungsreferenzen und Programmstruktur enthält. Muss vor get_variables aufgerufen werden. Gibt den für nachfolgende Variablenanalysen erforderlichen Datenbankpfad zurück.
get_control_flowBerechnet Kontrollflussgraphen anhand der Metadaten in der Datenbank.
get_paragraphsFragt Paragraph-Informationen aus der Metadaten-Datenbank ab.
execute_sql_queryFührt KI-generierte SQL-Abfragen auf der Metadaten-Datenbank aus.

Data Dictionary-Verwaltung

ToolBeschreibung
get_variablesGibt die Liste der Variablen zurück, die in dem mit scan_program gescannten Programm verwendet werden.
edit_data_dictionaryÖffnet die Data-Dictionary-Datei (DD.json) zur Überprüfung und Bearbeitung im Editor. Ermöglicht Benutzern das Hinzufügen von Geschäftsbeschreibungen für Variablen vor der Erstellung von Erklärungen.
sync_data_dictionarySynchronisiert dein lokales Data Dictionary mit Einträgen aus der auf dem Z-Understand-Server gespeicherten zentralen Kopie.

Code-Erklärung und -Erweiterung

ToolBeschreibung
persona_profileBeschreibt den bevorzugten Erklärungstyp des Benutzers für Programmerklärungen (Architekt, Entwickler oder Business).

Refactoring und Service-Extraktion

ToolBeschreibung
refactorInteraktives Tool zur Durchführung von Z-Understand-Refactoring-Operationen und zur Anleitung bei der Service-Extraktion.
submit_refactor_findingsFindet Stellen in einem Programm, die Kandidaten für die Extraktion von Service-Code sind.

Projektweite Asset-Erkennung über GraphQL

ToolBeschreibung
sign_in_to_z_understandMeldet sich bei Z Understand an und gibt Informationen über das verbundene Analyseprojekt zurück.
get_project_programsRuft alle Programme in einem Projekt ab (gibt die von anderen Tools benötigte progId zurück).
get_project_variablesRuft alle in einem bestimmten Programm definierten Variablen ab (erfordert progId).
get_project_tablesRuft alle in einem Projekt definierten Tabellen ab.
get_project_statement_typesRuft alle in einem Projekt verfügbaren Anweisungstypen ab.
get_project_paragraphFindet den Paragraphen, der eine bestimmte Anweisungszeile in einem Programm enthält.
get_project_variable_usage_paragraphsFindet alle Paragraphen in einem Programm, in denen eine bestimmte Variable verwendet wird.
get_project_resource_usageRuft Nutzungsinformationen für Ressourcen ab (Tabellen, Variablen, Includes, Bildschirme, Datasets).
get_project_inventoryRuft allgemeine Informationen darüber ab, wie viele Artefakte für jeden Typ im Projekt enthalten sind (COBOL-Programm, PL/I-Programm, SQL-Tabellen, IMS-Tabellen).
get_project_unused_paragraphs (3.0.20+)Ruft alle ungenutzten (toten oder unerreichbaren) Paragraphen über ein oder mehrere Programme hinweg ab. Wenn du beispielsweise den Prompt "zeige mir ungenutzte Paragraphen für Programm X" im Bob-Chat eingibst, zeigt die Antwort alle ungenutzten Paragraphen des angegebenen Programms an. Wenn du "zeige mir ungenutzte Paragraphen für Programmnamen, die EDIX enthalten" eingibst, zeigt die Antwort alle ungenutzten Paragraphen aus jedem Programm an, dessen Name "EDIX" enthält.
get_project_unused_programs (3.0.20+)Ruft alle ungenutzten (toten oder unerreichbaren) Programme innerhalb eines Projekts ab. Wenn du beispielsweise den Prompt "zeige mir die ungenutzten Programme im Projekt" im Bob-Chat eingibst, zeigt die Antwort alle ungenutzten Programme für das ausgewählte Projekt basierend auf den verfügbaren Datenbankeinträgen an.
execute_project_sql_query (3.1.0+)Führt native SQL-SELECT-Abfragen auf der vollständigen Projekt-Metadaten-Datenbank aus (Programme, Paragraphen, Variablen, Dateien, Cursor, SQL-Tabellen, Copybooks, Transaktionen, JCL-Jobs, CA7-Planungsdaten).

Z Open Editor- und ZCodeScan-Tools

ToolBeschreibung
zOpenEditor-architect
zopeneditor-cobol-get-program-control-flowRuft geparste Kontrollflussdaten vom COBOL-Language-Server ab, um die Programmstruktur und Ausführungspfade zu analysieren.
zopeneditor-cobol-get-data-flowVerfolgt den Datenfluss für ein bestimmtes COBOL-Datenelement und gibt eine grafische Darstellung zurück, wie das Element im Programm modifiziert wird.
zopeneditor-pli-get-program-control-flowRuft geparste Kontrollflussdaten vom PL/I-Language-Server ab, um die Programmstruktur und Ausführungspfade zu analysieren.
zopeneditor-get-embedded-languagesErkennt eingebettete Sprachen in einer COBOL- oder PL/I-Datei.
zOpenEditor-code
zcodescan-check-current-programFührt einen IBM ZCodeScan für die aktuell im Editor geöffnete COBOL- oder PL/I-Programmdatei aus. Der Scan parst das Programm und liefert Linter-ähnliche Hinweise zur Programmqualität zurück.
zcodescan-check-list-of-local-programsFührt einen IBM ZCodeScan für COBOL- oder PL/I-Dateien in deinem lokalen Workspace aus. Die Dateien werden über eine Liste von Glob-Suchmustern identifiziert, die alle im Editor-Workspace zu scannenden Programme definieren.
zopeneditor-cobol-format-fileFormatiert eine COBOL-Datei unter Verwendung des COBOL-Language-Servers und einer Z-Code-Formatdatei.
zopeneditor-cobol-format-multiple-filesFormatiert mehrere COBOL-Dateien unter Verwendung des COBOL-Language-Servers und einer Z-Code-Formatdatei.
zopeneditor-cobol-renumber-fileNummeriert eine COBOL-Datei mithilfe des COBOL-Language-Servers neu, um jeder Zeile in der Datei Zeilennummern hinzuzufügen.
zopeneditor-cobol-renumber-multiple-filesNummeriert mehrere COBOL-Dateien im Workspace mithilfe des COBOL-Language-Servers neu.
zopeneditor-cobol-unnumber-fileEntfernt Zeilennummern aus jeder Zeile einer COBOL-Datei mithilfe des COBOL-Language-Servers.
zopeneditor-cobol-unnumber-multiple-filesEntfernt Zeilennummern aus jeder Zeile mehrerer COBOL-Dateien im Workspace mithilfe des COBOL-Language-Servers.

Code-Optimierungs-Tools (3.1.0+)

ToolBeschreibung
submit_optimize_findingsParst einen Empfehlungsbericht und übermittelt jede Empfehlung als Bob Finding für die entsprechende COBOL-Datei.

Tool-Gruppen

Tool-Gruppen kategorisieren Funktionen in logische Domänen, um Auffindbarkeit, Zugriffskontrolle und Benutzerfreundlichkeit auf der gesamten Plattform zu verbessern. Jede Gruppe repräsentiert eine Reihe verwandter Operationen (z. B. Codeanalyse und Integrationen), sodass Benutzer und Systeme Funktionen je nach Einsatzzweck effizient organisieren und aufrufen können.

KategorieTool-GruppeBeschreibungID
CoreCoreFür primäre Operationen erforderliches Basis-Tool-Set.core
CoreHintBietet kontextbezogene Vorschläge, Anleitungen oder Inline-Hinweise zur Unterstützung von Benutzern.toolHint
Data & APIScanDient zum Scannen von Codebasen, Ressourcen oder Umgebungen.scan
Data & APIData DictionaryErmöglicht die Interaktion mit Metadaten, Schemadefinitionen und strukturierten Datenbeschreibungen.dataDictionary
Data & APIGraphQLÜbernimmt GraphQL-Abfragegenerierung, -Ausführung und Schemaoperationen.graphQl
Code IntelligenceAnalysisFührt statische/dynamische Analysen für Einblicke in Codequalität, Abhängigkeiten und Probleme durch.analysis
Code IntelligenceExplainGeneriert Erklärungen zu Codelogik, Funktionen und Workflows.explain
Code ModificationRefactorUnterstützt die Umstrukturierung von Code ohne Änderung der Funktionalität.refactor
IntegrationszOpenEditor ArchitectAuf Architektur fokussierte Tools für zOpenEditor-Workflows.zOpenEditor-architect
IntegrationszOpenEditor CodeTools auf Code-Ebene innerhalb von zOpenEditor.zOpenEditor-code
IntegrationszOpenDebug Code (3.1.0+)Tools auf Code-Ebene innerhalb von zOpenDebug.zOpenDebug-code
Wie ist dieses Thema?