Analisar e entender os resultados da avaliação

Nesta página, descrevemos como analisar a avaliação dos recursos descobertos e analisar os arquivos de origem do aplicativo usando a IA generativa.

Os resultados da avaliação fornecem detalhes como as linhas de código e o número de chamadas encontradas no aplicativo, o que ajuda a planejar a migração. Além disso, a análise fornece um resumo do programa, o que ajuda você a entender a semântica dele.

Antes de começar

• Criar uma avaliação

Analisar os resultados da avaliação de aplicativos

Para abrir uma avaliação e analisar os resultados, siga estas etapas:

1. Abra a Mainframe Assessment Tool em um navegador da Web.
2. No menu de navegação, clique em Avaliações.
3. Na página Avaliações, clique na seta de expansão para abrir uma avaliação específica.

O painel de avaliação aparece e inclui as seguintes páginas:

• Descoberta: descubra e analise o código-fonte.
• Domínios: analise os insights gerados por IA para os domínios da sua empresa.
• Recursos: analise os insights gerados por IA para recursos.
• Regras de negócios: saiba como extrair regras de negócios e confira visualizações hierárquicas de extração de regras de negócios (BRE) na guia Fluxo de negócios.

Descobrir e analisar o código-fonte

A página Descoberta oferece uma visão geral da análise do código-fonte do aplicativo que você enviou para avaliação.

Para descobrir e analisar seu código-fonte, siga estas etapas:

1. Clique em Encontrar inventário.

2. Para selecionar um tipo de relatório, na lista Tipo de relatório, escolha o tipo que você quer visualizar.

   A tabela a seguir lista diferentes tipos de relatórios e as descrições deles:

   Tipo de relatório	Descrição	Detalhes
   Inventário	Fornece detalhes sobre o número de arquivos, linhas de código e tipos de programas, incluindo arquivos de configuração do programador (BMC Control-M).	Contagem por tipo de arquivo:número de arquivos por idioma. Linhas de código por tipo de arquivo:número de linhas de código por tipo de arquivo. Linhas de código reais x comentadas:número de linhas de código comparado ao número de linhas de comentários. Categoria – lote/on-line:número de programas em lote comparado a programas on-line. Total de linhas de código:número total de linhas de código em todos os arquivos incluídos na avaliação. Use esses dados para entender o tamanho geral da base de código.
   Tipos de módulos	Categoriza módulos com base nas relações de chamada deles, especificamente para COBOL e JCL.	Módulos chamados de programas COBOL:número de módulos chamados diretamente do código-fonte COBOL. Módulos chamados da JCL:número de módulos chamados diretamente nos arquivos JCL. Cinco principais utilitários de módulo COBOL:lista de utilitários usados com frequência pelos seus programas COBOL. Os cinco principais utilitários de módulo JCL:lista de utilitários usados com frequência em jobs JCL.
   Complexidade	Para programas COBOL, mostra a complexidade do código-fonte usando a complexidade ciclomática (métrica de McCabe). As métricas de McCabe representam o número de caminhos de execução ou pontos de decisão no código-fonte. Esse valor qualitativo ajuda a identificar quais aplicativos podem ser mais fáceis ou mais complexos de modernizar.	Tabela de complexidade:um detalhamento arquivo por arquivo das métricas de complexidade calculadas, como a contagem de complexidade. Uma contagem de complexidade mais alta sugere um programa mais complexo. Simples: complexidade < 100 Média: 100 <= complexidade < 500 Complexa: 500 <= complexidade < 1000 Muito complexo: 1000 <= complexidade Mapeamento de complexidade:representação visual da tabela de complexidade, que oferece uma visão geral da complexidade na base de código.
   Dependência de chamada	Mostra o gráfico de chamadas de todas as entidades enviadas, incluindo chamadas COBOL dinâmicas resolvidas e chamadas extraídas de outras linguagens compatíveis. A resolução de chamadas para PL/I só é compatível com chamadas estáticas.	O tamanho dos ícones está relacionado ao número de chamadas recebidas e feitas.
   Módulos de driver	Mostra módulos que chamam muitos outros módulos.	O tamanho dos ícones está relacionado ao número de chamadas recebidas e feitas.
   Conjuntos de dados	Fornece uma visão detalhada de todos os conjuntos de dados envolvidos na avaliação.	Linhagem do conjunto de dados:mostra como cada conjunto de dados é usado em diferentes jobs, etapas e programas. Campos do conjunto de dados:lista todos os campos em cada conjunto de dados, além dos tipos de dados, posições iniciais, tamanhos, indicadores principais e outras propriedades.
   Bancos de dados	Lista as tabelas do DB2 e os segmentos do IMS usados na avaliação.	Detalha a linhagem de dados, as colunas e as propriedades de cada segmento e tabela.
   Programas órfãos	Lista todos os programas que não chamam nem são chamados por outra entidade.	Nome do programa:identifica o módulo do programa encontrado no código-fonte enviado, mas que não parece ser chamado ou executado por nenhuma outra parte do aplicativo. Arquivo de origem original:o nome do arquivo que contém o código-fonte do nome do programa correspondente.
   Módulos ausentes	Mostra módulos usados no código, mas não encontrados durante a análise de entrada.	Ausente do arquivo:o arquivo de origem específico que contém uma referência a um módulo ou componente que não foi encontrado nos arquivos de avaliação enviados. Nome do módulo ausente:o nome do módulo ou componente que está faltando nos arquivos enviados. Tipo de módulo ausente:o tipo do componente ausente, que ajuda a entender a natureza da dependência. Por exemplo, DATASET_SCHEMA, COPYBOOK ou PROC. Use essa guia para entender o que estava faltando e considere adicionar esses módulos antes de executar a avaliação novamente.
   Problemas de análise	Mostra todos os erros encontrados durante a análise do código-fonte.	Arquivo de origem:nome do arquivo específico do código-fonte enviado em que o analisador encontrou um problema. Gravidade:indica a gravidade do problema de análise. Por exemplo, Warning. Problemas:fornece uma descrição do problema encontrado pelo analisador de código.
   Chamadas do CICS	Mostra as chamadas do CICS feitas em cada programa e os parâmetros delas.	É possível filtrar os resultados por comando, programa ou parâmetro.
   Conexões de jobs JCL	Mostra as dependências entre jobs JCL com base em conjuntos de dados compartilhados, tabelas do DB2 e segmentos do IMS.	Jobs conectados com base em uma fonte de dados compartilhada:mostra a conexão entre dois jobs se um deles grava dados em uma fonte de dados compartilhada e o outro lê dessa mesma fonte. Os jobs que apenas leem da mesma fonte de dados não são conectados entre si. Jobs conectados com base em uma fonte de dados compartilhada (visualização em tabela): mostra os detalhes da conexão entre os jobs. Dependências de jobs de gravadores para leitores:mostra o job do gravador, o programa do gravador, a fonte de dados, o programa do leitor e o job do leitor.
   Parâmetros de substituição da JCL	Mostra os valores resolvidos dos parâmetros JCL.	Nome do job:identifica de forma exclusiva um job JCL específico, um conjunto de instruções para o mainframe que executa um processo em lote. Nome da etapa:identifica uma única etapa de execução em um job JCL. Um job consiste em uma ou mais etapas. Cada etapa geralmente executa um programa ou procedimento específico. Nome da definição de dados:mostra o nome de uma instrução de definição de dados em um procedimento JCL. Nome do conjunto de dados:identifica o nome de um arquivo ou conjunto de dados, conforme ele existe nos volumes de armazenamento do mainframe. Nome do parâmetro:refere-se a um parâmetro simbólico que age como uma variável em um procedimento JCL. Valor do parâmetro:refere-se ao valor atribuído a um parâmetro simbólico em um procedimento JCL.
   Transações	Mostra as relações extraídas entre programas, transações e telas para IMS e CICS.	Programa:o nome de um programa IMS ou CICS on-line. Transação:um código de transação IMS ou CICS que pode ser usado para programar a execução do programa. Tela:o nome da tela ou do mapa usado pelo programa ou pela transação.
   Entidades duplicadas	Lista os programas que têm o mesmo ID.	Nome:o nome de um dos programas em um conjunto de programas com o mesmo ID. Tipo:o tipo do programa, por exemplo, COBOL ou JCL. Arquivo de origem:o arquivo de origem que contém esse programa. Arquivo de origem adicional:lista os outros arquivos de origem que contêm programas com o mesmo ID.
   Unidades migradas	Divide os recursos em unidades de migração para gerar um plano preliminar.	Gráfico de unidades migradas:mostra como as unidades de migração dependem umas das outras em um diagrama de dependência (DAG). Lista de unidades migradas:a lista de unidades migradas com o nome das unidades migradas, a contagem de recursos e a contagem de linhas de origem. Você também pode conferir o gráfico de recursos e a lista de recursos e tipos de recursos associados a uma unidade migrável. Gráfico de recursos:mostra as dependências entre recursos em uma unidade migrável. Lista de recursos:lista os recursos na unidade migrável com colunas para nome da unidade migrável, nome do recurso, tipo de recurso e linhas de código (linhas de origem).

Analisar insights gerados com IA para seus domínios comerciais

A página Domínios oferece insights gerados por IA para os domínios comerciais associados a essa avaliação. Uma avaliação pode ter vários domínios, tantos quanto você especificou ao criar a avaliação. Cada domínio tem um status, resumo, lógica de negócios, fluxo de dados e recursos associados próprios. Os domínios ajudam a dividir partes da sua base de código como pertencentes a uma função comercial específica.

Para usar esse recurso, é necessário ativar os insights de IA e adicionar um domínio comercial ao criar a avaliação. Se essa página não estiver disponível, crie uma nova avaliação e ative os insights de IA.

Para receber uma descrição gerada por IA dos domínios comerciais do seu aplicativo, siga estas etapas:

1. Clique em Domains.

   Uma lista de domínios é exibida, junto com o status de cada um.

2. Para conferir o resumo, a lógica de negócios e o fluxo de dados de um domínio específico, clique em Mostrar mais.

   Você vê descrições detalhadas geradas por IA do domínio comercial do seu aplicativo. Essas descrições incluem a finalidade, a lógica, o processamento de dados, o fluxo de dados e as dependências de dados.

3. Para pesquisar um domínio específico, digite o nome dele no campo Pesquisar.

4. Opcional: para conferir a lista de recursos associados a esse domínio, clique em Ver recursos.

Imagens de domínio

Observação: este é um recurso experimental.

A página Domínios também mostra imagens geradas por IA que representam seus domínios comerciais. Cada imagem de domínio é gerada com base na especificação do domínio para representar visualmente as funções e os sistemas descritos nele.

A geração de imagens de domínio tem os seguintes requisitos:

• Uso do endpoint global da Agent Platform.
• Modelos de IA compatíveis: Gemini 3.5 Flash, Gemini 3.1 Pro (pré-lançamento) e Gemini 3 Flash (pré-lançamento). A Mainframe Assessment Tool usa a imagem do Gemini 3 Pro (pré-lançamento) para geração de imagens de domínio.

Analisar insights gerados com IA para recursos

A página Recursos oferece um resumo, uma lógica detalhada e sugestões de código para um programa ou job no seu aplicativo de mainframe. Também é possível conferir o status, o tipo, o idioma e o modo de execução (em lote ou on-line) de cada recurso.

Para recursos de configuração do programador, como BMC Control-M, a Mainframe Assessment Tool fornece insights gerados por IA que ajudam a visualizar o fluxo de trabalho do programador, incluindo uma lista de jobs programados, cronogramas para programações diárias, semanais ou mensais e gráficos de dependência que mostram as relações entre os jobs. Esses dados também estão disponíveis nos relatórios exportados em HTML e JSON.

A página Recursos mostra uma nova entrada na tabela para cada recurso descoberto, mostrando o status da avaliação.

• Pendente:o recurso está aguardando a análise.
• Em andamento:a avaliação do recurso está em andamento.
• Concluída:a análise de recursos foi concluída.
• Aviso:a avaliação foi concluída com um aviso não bloqueador durante a geração de código.

Para restringir a seleção de recursos, aplique filtros no campo Filter. Selecione um nome de propriedade para filtrar e insira um valor de propriedade. Por exemplo, para filtrar todos os recursos pelo status da avaliação, defina o nome da propriedade como Status e selecione um valor como Warning ou Completed.

Para conferir os detalhes de um recurso, siga estas etapas:

1. Na tabela Todos os recursos, clique no nome de um recurso.

   A página Resumo aparece. Ela fornece um resumo gerado por IA do recurso, além do caso de negócios e da análise de interação do usuário.

2. Para conferir a lógica detalhada sobre o recurso, clique em Lógica detalhada.

   Para programas COBOL e jobs JCL, a página Lógica detalhada fornece detalhes granulares, no nível do parágrafo e do método sobre o recurso, além de casos de teste. Se o job JCL for referenciado por uma configuração de agendador na avaliação, essa página também vai incluir informações sobre os pré-requisitos do job do agendador, os jobs dependentes e os cronogramas de execução.

3. Para conferir os campos de saída, clique em Campos de saída.

   Para programas COBOL, a página Campos de saída oferece um resumo de campos de dados específicos que um programa gera e suas descrições.

4. Para ver as sugestões de código, clique em Sugestões de código.

   Para programas COBOL, a página Sugestões de código oferece uma sugestão de código gerada por IA nas linguagens de programação selecionadas ao criar a avaliação.

5. Para acessar a tela do BMS, clique em Mapas do BMS.

   Para recursos da BMS, a página Mapas da BMS mostra a tela da interface.

Peça ao Gemini

Observação: para usar o recurso Peça ao Gemini, você precisa configurar e usar o endpoint global da Agent Platform porque esse recurso usa modelos de prévia do Gemini.

O painel de chat Perguntar ao Gemini permite analisar sua avaliação usando linguagem natural. Você pode fazer perguntas sobre código-fonte e lógica de negócios, consultar dados de avaliação, como contagem de linhas ou métricas de complexidade, e gerar visualizações, como gráficos.

Para usar o recurso Peça ao Gemini, siga estas etapas:

1. Clique no ícone Perguntar ao Gemini.

2. Digite sua pergunta e pressione Enter. As respostas são transmitidas em tempo real.

3. Para iniciar uma conversa, clique em Novo chat.

4. Para ver ou retomar conversas anteriores, clique em Mais > Mostrar histórico de chat.

5. Para excluir uma conversa, clique em Mais > Mostrar histórico de chat e clique em excluir a conversa que você quer remover.

6. Para mudar para a experiência de chat clássica, clique em Mais > Usar o chat clássico. Para voltar, clique em Mais > Usar o chat avançado.

A seguir

• Saiba como exportar os resultados da avaliação.
• Saiba como extrair regras de negócios.