Usando ferramentas e grupos de ferramentas

Conheça as ferramentas e grupos de ferramentas disponíveis no IBM Bob Premium Package for Z.

Ferramentas

As ferramentas são blocos de construção de baixo nível e específicos por função que potencializam os workflows de scanning, análise, transformação, validação, refatoração e documentação. Essas ferramentas interagem diretamente com código-fonte de programas, bancos de dados de análise e artefatos de transformação para fornecer resultados precisos e repetíveis.

As tabelas a seguir listam as ferramentas incluídas no IBM® Bob Premium Package for Z.

Scanning de código-fonte e análise de fluxo de controle

FerramentaDescrição
scan_programEscaneia um programa COBOL ou PL/I para gerar um banco de dados de metadados contendo uso de variáveis, referências de instrução e estrutura do programa. Deve ser chamada antes de get_variables. Retorna o caminho do banco de dados necessário para análise de variáveis subsequente.
get_control_flowCalcula grafos de fluxo de controle usando metadados no banco de dados.
get_paragraphsConsulta informações de parágrafos do banco de dados de metadados.
execute_sql_queryExecuta consultas SQL geradas por IA no banco de dados de metadados.

Gerenciamento de dicionário de dados

FerramentaDescrição
get_variablesRetorna a lista de variáveis usadas no programa escaneado com scan_program.
edit_data_dictionaryAbre o arquivo de dicionário de dados (DD.json) no editor para revisão e modificação pelo usuário. Permite que os usuários adicionem descrições de negócio para variáveis antes de gerar explicações.
sync_data_dictionarySincroniza seu dicionário de dados local com as entradas da cópia central armazenada no servidor Z Understand.

Explicação e expansão de código

FerramentaDescrição
persona_profileDescreve o tipo preferido de explicação do usuário para explicações de programas (arquiteto, desenvolvedor ou negócio).

Refatoração e extração de serviços

FerramentaDescrição
refactorFerramenta interativa para realizar operações de refatoração do Z Understand e orientar a extração de serviços.
submit_refactor_findingsEncontra localizações em um programa que são candidatos para extração de código de serviço.

Descoberta de ativos em todo o projeto via GraphQL

FerramentaDescrição
sign_in_to_z_understandFaz login no Z Understand e retorna informações sobre o projeto de análise conectado.
get_project_programsRecupera todos os programas em um projeto (retorna progId necessário por outras ferramentas).
get_project_variablesRecupera todas as variáveis definidas em um programa específico (requer progId).
get_project_tablesRecupera todas as tabelas definidas em um projeto.
get_project_statement_typesRecupera todos os tipos de instrução disponíveis em um projeto.
get_project_paragraphEncontra o parágrafo que contém uma linha de instrução específica em um programa.
get_project_variable_usage_paragraphsEncontra todos os parágrafos em um programa onde uma variável específica é usada.
get_project_resource_usageRecupera informações de uso para recursos (tabelas, variáveis, includes, telas, dataset).
get_project_inventoryRecupera informações gerais sobre quantos artefatos estão incluídos no projeto para cada tipo (programa COBOL, programa PL/I, tabelas SQL, tabelas IMS).
get_project_unused_paragraphs (3.0.20+)Recupera todos os parágrafos não utilizados (mortos ou inacessíveis) em um ou mais programas. Por exemplo, ao inserir o prompt "informe os parágrafos não utilizados para o programa X" no chat do Bob, a resposta exibe todos os parágrafos não utilizados associados ao programa especificado. Ao inserir "informe os parágrafos não utilizados para programas com nomes contendo 'EDIX'", a resposta exibe todos os parágrafos não utilizados de todos os programas cujo nome contém "EDIX".
get_project_unused_programs (3.0.20+)Recupera todos os programas não utilizados (mortos ou inacessíveis) dentro de um projeto. Por exemplo, ao inserir o prompt "informe os programas não utilizados dentro do projeto" no chat do Bob, a resposta exibe todos os programas não utilizados para o projeto selecionado com base nos registros de banco de dados disponíveis.
execute_project_sql_query (3.1.0+)Executa consultas SQL SELECT brutas no banco de dados de metadados completo do projeto (programas, parágrafos, variáveis, arquivos, cursores, tabelas SQL, copybooks, transações, jobs JCL, dados de agendamento CA7).

Ferramentas do Z Open Editor e ZCodeScan

FerramentaDescrição
zOpenEditor-architect
zopeneditor-cobol-get-program-control-flowRecupera dados de fluxo de controle analisados do COBOL Language Server para analisar a estrutura do programa e os caminhos de execução.
zopeneditor-cobol-get-data-flowRastreia o fluxo de dados para um item de dados COBOL específico e retorna uma representação em grafo de como o item é modificado no programa.
zopeneditor-pli-get-program-control-flowRecupera dados de fluxo de controle analisados do PL/I Language Server para analisar a estrutura do programa e os caminhos de execução.
zopeneditor-get-embedded-languagesDetecta linguagens incorporadas em um arquivo COBOL ou PL/I.
zOpenEditor-code
zcodescan-check-current-programExecuta um IBM ZCodeScan no arquivo de programa COBOL ou PL/I atualmente aberto no editor. O scan analisa o programa e retorna problemas no estilo linter sobre a qualidade do programa.
zcodescan-check-list-of-local-programsExecuta um IBM ZCodeScan em arquivos COBOL ou PL/I no seu workspace local. Os arquivos são identificados por uma lista de padrões de busca glob que definem todos os programas a serem escaneados no workspace do editor.
zopeneditor-cobol-format-fileFormata um arquivo COBOL usando o COBOL Language Server e um arquivo Z Code Format.
zopeneditor-cobol-format-multiple-filesFormata múltiplos arquivos COBOL usando o COBOL Language Server e um arquivo Z Code Format.
zopeneditor-cobol-renumber-fileRenumera um arquivo COBOL usando o COBOL Language Server para adicionar números de sequência a cada linha do arquivo.
zopeneditor-cobol-renumber-multiple-filesRenumera múltiplos arquivos COBOL no workspace usando o COBOL Language Server.
zopeneditor-cobol-unnumber-fileRemove números de sequência de cada linha em um arquivo COBOL usando o COBOL Language Server.
zopeneditor-cobol-unnumber-multiple-filesRemove números de sequência de cada linha em múltiplos arquivos COBOL no workspace usando o COBOL Language Server.

Ferramentas de otimização de código (3.1.0+)

FerramentaDescrição
submit_optimize_findingsAnalisa um relatório de recomendações e submete cada recomendação como um Bob Finding no arquivo COBOL relevante.

Grupos de ferramentas

Os grupos de ferramentas categorizam capacidades em domínios lógicos para melhorar a descoberta, o controle de acesso e a usabilidade na plataforma. Cada grupo representa um conjunto de operações relacionadas, como análise de código e integrações, permitindo que usuários e sistemas organizem e invoquem funcionalidades de forma eficiente com base na intenção.

CategoriaGrupo de ferramentasDescriçãoID
CoreCoreConjunto base de ferramentas necessário para operações primárias.core
CoreHintFornece sugestões contextuais, orientação ou dicas inline para auxiliar os usuários.toolHint
Dados & APIScanUsado para escanear bases de código, recursos ou ambientes.scan
Dados & APIData DictionaryPermite interação com metadados, definições de schema e descrições de dados estruturados.dataDictionary
Dados & APIGraphQLTrata geração de consultas GraphQL, execução e operações de schema.graphQl
Inteligência de CódigoAnalysisRealiza análise estática/dinâmica para insights sobre qualidade de código, dependências e problemas.analysis
Inteligência de CódigoExplainGera explicações de lógica de código, funções e workflows.explain
Modificação de CódigoRefactorSuporta reestruturação de código sem alterar a funcionalidade.refactor
IntegraçõeszOpenEditor ArchitectFerramentas focadas em arquitetura para workflows do zOpenEditor.zOpenEditor-architect
IntegraçõeszOpenEditor CodeFerramentas em nível de código dentro do zOpenEditor.zOpenEditor-code
IntegraçõeszOpenDebug Code (3.1.0+)Ferramentas em nível de código dentro do zOpenDebug.zOpenDebug-code
Como está este tópico?