Uso degli strumenti e dei gruppi di strumenti

Scopri gli strumenti e i gruppi di strumenti disponibili in IBM Bob Premium Package for Z.

Strumenti

Gli strumenti sono componenti funzionali di basso livello che supportano i workflow di scansione, analisi, trasformazione, validazione, refactoring e documentazione. Questi strumenti interagiscono direttamente con il codice sorgente dei programmi, i database di analisi e gli artefatti di trasformazione per fornire risultati precisi e ripetibili.

Le seguenti tabelle elencano gli strumenti inclusi in IBM® Bob Premium Package for Z.

Scansione del codice sorgente e analisi del flusso di controllo

StrumentoDescrizione
scan_programScansiona un programma COBOL o PL/I per generare un database di metadati contenente l'utilizzo delle variabili, i riferimenti alle istruzioni e la struttura del programma. Deve essere chiamato prima di get_variables. Restituisce il percorso del database necessario per la successiva analisi delle variabili.
get_control_flowCalcola i grafi del flusso di controllo usando i metadati nel database.
get_paragraphsInterroga le informazioni sui paragrafi dal database dei metadati.
execute_sql_queryEsegue query SQL generate dall'AI sul database dei metadati.

Gestione del data dictionary

StrumentoDescrizione
get_variablesRestituisce l'elenco delle variabili usate nel programma scansionato con scan_program.
edit_data_dictionaryApre il file del data dictionary (DD.json) nell'editor per la revisione e la modifica da parte dell'utente. Consente agli utenti di aggiungere descrizioni aziendali per le variabili prima di generare le spiegazioni.
sync_data_dictionarySincronizza il data dictionary locale con le voci della copia centrale archiviata sul server Z Understand.

Spiegazione ed espansione del codice

StrumentoDescrizione
persona_profileDescrive il tipo di spiegazione preferito dall'utente per le spiegazioni dei programmi (architetto, sviluppatore o business).

Refactoring ed estrazione di servizi

StrumentoDescrizione
refactorStrumento interattivo per eseguire operazioni di refactoring Z Understand e guidare l'estrazione dei servizi.
submit_refactor_findingsTrova le posizioni in un programma che sono candidate all'estrazione di codice di servizio.

Scoperta di asset a livello di progetto tramite GraphQL

StrumentoDescrizione
sign_in_to_z_understandAccede a Z Understand e restituisce informazioni sul progetto di analisi connesso.
get_project_programsRecupera tutti i programmi in un progetto (restituisce progId richiesto dagli altri strumenti).
get_project_variablesRecupera tutte le variabili definite in un programma specifico (richiede progId).
get_project_tablesRecupera tutte le tabelle definite in un progetto.
get_project_statement_typesRecupera tutti i tipi di istruzione disponibili in un progetto.
get_project_paragraphTrova il paragrafo che contiene una specifica riga di istruzione in un programma.
get_project_variable_usage_paragraphsTrova tutti i paragrafi in un programma in cui viene usata una specifica variabile.
get_project_resource_usageRecupera le informazioni sull'utilizzo delle risorse (tabelle, variabili, include, schermate, dataset).
get_project_inventoryRecupera informazioni generali su quanti artefatti sono inclusi nel progetto per ogni tipo (programma COBOL, programma PL/I, tabelle SQL, tabelle IMS).
get_project_unused_paragraphs (3.0.20+)Recupera tutti i paragrafi inutilizzati (dead o irraggiungibili) in uno o più programmi. Ad esempio, inserendo il prompt "dimmi i paragrafi inutilizzati del programma X" nella chat Bob, la risposta mostra tutti i paragrafi inutilizzati associati al programma specificato. Inserendo "dimmi i paragrafi inutilizzati dei programmi il cui nome contiene 'EDIX'", la risposta mostra tutti i paragrafi inutilizzati di ogni programma il cui nome contiene "EDIX".
get_project_unused_programs (3.0.20+)Recupera tutti i programmi inutilizzati (dead o irraggiungibili) all'interno di un progetto. Ad esempio, inserendo il prompt "dimmi i programmi inutilizzati nel progetto" nella chat Bob, la risposta mostra tutti i programmi inutilizzati per il progetto selezionato in base ai record del database disponibili.
execute_project_sql_query (3.1.0+)Esegue query SQL SELECT raw sul database completo dei metadati del progetto (programmi, paragrafi, variabili, file, cursori, tabelle SQL, copybook, transazioni, job JCL, dati di scheduling CA7).

Strumenti Z Open Editor e ZCodeScan

StrumentoDescrizione
zOpenEditor-architect
zopeneditor-cobol-get-program-control-flowRecupera i dati del flusso di controllo analizzati dal COBOL Language Server per analizzare la struttura del programma e i percorsi di esecuzione.
zopeneditor-cobol-get-data-flowTraccia il flusso di dati per un dato elemento dati COBOL e restituisce una rappresentazione grafica di come l'elemento viene modificato nel programma.
zopeneditor-pli-get-program-control-flowRecupera i dati del flusso di controllo analizzati dal PL/I Language Server per analizzare la struttura del programma e i percorsi di esecuzione.
zopeneditor-get-embedded-languagesRileva i linguaggi embedded in un file COBOL o PL/I.
zOpenEditor-code
zcodescan-check-current-programEsegue uno ZCodeScan IBM sul file di programma COBOL o PL/I attualmente aperto nell'editor. La scansione analizza il programma e restituisce problemi in stile linter sulla qualità del programma.
zcodescan-check-list-of-local-programsEsegue uno ZCodeScan IBM su file COBOL o PL/I nel workspace locale. I file vengono identificati tramite un elenco di pattern di ricerca glob che definiscono tutti i programmi da scansionare nel workspace dell'editor.
zopeneditor-cobol-format-fileFormatta un file COBOL usando il COBOL Language Server e un file Z Code Format.
zopeneditor-cobol-format-multiple-filesFormatta più file COBOL usando il COBOL Language Server e un file Z Code Format.
zopeneditor-cobol-renumber-fileRinumera un file COBOL usando il COBOL Language Server per aggiungere numeri di sequenza a ogni riga del file.
zopeneditor-cobol-renumber-multiple-filesRinumera più file COBOL nel workspace usando il COBOL Language Server.
zopeneditor-cobol-unnumber-fileRimuove i numeri di sequenza da ogni riga in un file COBOL usando il COBOL Language Server.
zopeneditor-cobol-unnumber-multiple-filesRimuove i numeri di sequenza da ogni riga in più file COBOL nel workspace usando il COBOL Language Server.

Strumenti di ottimizzazione del codice (3.1.0+)

StrumentoDescrizione
submit_optimize_findingsAnalizza un report di raccomandazioni e invia ogni raccomandazione come Bob Finding sul file COBOL pertinente.

Gruppi di strumenti

I gruppi di strumenti categorizzano le funzionalità in domini logici per migliorare la scoperta, il controllo degli accessi e l'usabilità sulla piattaforma. Ogni gruppo rappresenta un insieme di operazioni correlate, come l'analisi del codice e le integrazioni, consentendo a utenti e sistemi di organizzare e richiamare le funzionalità in modo efficiente in base all'intento.

CategoriaGruppo di strumentiDescrizioneID
CoreCoreSet di strumenti base necessari per le operazioni principali.core
CoreHintFornisce suggerimenti contestuali, indicazioni o hint inline per assistere gli utenti.toolHint
Dati e APIScanUsato per la scansione di codebase, risorse o ambienti.scan
Dati e APIData DictionaryAbilita l'interazione con metadati, definizioni di schema e descrizioni di dati strutturati.dataDictionary
Dati e APIGraphQLGestisce la generazione, l'esecuzione e le operazioni sullo schema GraphQL.graphQl
Code IntelligenceAnalysisEsegue analisi statica/dinamica per insight sulla qualità del codice, le dipendenze e i problemi.analysis
Code IntelligenceExplainGenera spiegazioni della logica del codice, delle funzioni e dei workflow.explain
Modifica del codiceRefactorSupporta la ristrutturazione del codice senza modificarne le funzionalità.refactor
IntegrazionizOpenEditor ArchitectStrumenti orientati all'architettura per i workflow zOpenEditor.zOpenEditor-architect
IntegrazionizOpenEditor CodeStrumenti a livello di codice all'interno di zOpenEditor.zOpenEditor-code
IntegrazionizOpenDebug Code (3.1.0+)Strumenti a livello di codice all'interno di zOpenDebug.zOpenDebug-code
Come valuti questo argomento?