Criar e atualizar avaliações

Nesta página, descrevemos como fazer upload dos aplicativos para a Mainframe Assessment Tool e realizar uma avaliação dos recursos que ela descobre na base de código enviada.

Você pode fazer uma descoberta de ativos por conta própria ou pedir ajuda a um engenheiro de clientes do Google.

Antes de começar

Para se preparar para a avaliação, verifique se você concluiu os seguintes pré-requisitos:

• Configurar o projeto do Google Cloud para a Mainframe Assessment Tool
• Configurar e acessar a Mainframe Assessment Tool

Fazer upload dos arquivos de aplicativos de mainframe para a Mainframe Assessment Tool

Para fazer upload dos arquivos do aplicativo para a ferramenta de avaliação do mainframe, siga estas etapas:

1. Crie um arquivo ZIP com todos os aplicativos que você quer migrar.

   A ferramenta de avaliação do mainframe só aceita arquivos ZIP com tamanho máximo de 400 MB. Se o arquivo ZIP do aplicativo for maior que 400 MB, divida-o em arquivos ZIP menores com base nos domínios comerciais e faça upload de um arquivo ZIP para cada domínio.

   Se os aplicativos contiverem referências a artefatos externos, como programas ou tabelas, recomendamos que você inclua essas dependências também. Se disponível, forneça o código-fonte dos seguintes tipos:

   • Programas COBOL (cob e cbl)
   • Copybooks COBOL (inc e cpy)
   • Programas Easytrieve (ezt)
   • Programas HLASM (asm)
   • Jobs JCL (jcl)
   • Procedimentos JCL (proc)
   • A JCL inclui
   • Dados do cartão JCL (ctl)
   • Programas PL/I (pli e pl1)
   • Programas RPG/RPGLE (rpg e rpgle)
   • Arquivos de inclusão RPG/RPGLE (rpginc e rpgleinc)

   Não inclua binários e outros arquivos que não sejam de origem no arquivo ZIP.

2. Para fazer upload do arquivo ZIP na ferramenta de avaliação do mainframe, siga estas etapas:

   1. Para abrir a ferramenta de avaliação do mainframe na sua máquina local, abra uma janela do navegador da Web e acesse http://localhost:PORT.

      Substitua PORT pelo número da porta que você usou na máquina local para a conexão em túnel com a Mainframe Assessment Tool.

   2. Na página Início, clique em Criar avaliação.

   3. Em "Nome", digite um nome.

   4. Opcional: em "Descrição", insira uma descrição para a avaliação.

   5. Para fazer upload de um arquivo ZIP, clique em Selecionar arquivo. O navegador de arquivos é aberto. Selecione um arquivo ZIP para fazer upload. Só é possível fazer upload de um arquivo por vez.

   6. Clique em Próxima.

3. Para configurar insights gerados por IA, siga estas etapas:

   1. Para gerar resumos no nível do parágrafo para código COBOL, selecione Resumos detalhados. Essa opção fica selecionada por padrão.

   2. Para gerar casos de teste para as especificações de avaliação geradas pelo Gemini, selecione Casos de teste. Por padrão, essa opção não é selecionada.

   3. Para gerar exemplos de código que traduzem linguagens de mainframe para Python, Java, C# e SQL, selecione Sugestões de código. Por padrão, essa opção não é selecionada.

   4. Em Dicas de conjunto de tecnologias, insira um texto que ajude o Gemini a gerar código para um conjunto de tecnologias específico. Por exemplo, insira Spring Boot and MySQL.

   5. Clique em Próxima.

4. Opcional: para adicionar um ou mais domínios que representam uma área distinta de funcionalidade, clique em Adicionar domínio.

   Essas informações são usadas para atribuição automática e permitem filtrar e analisar resultados com base em contextos específicos após a conclusão da avaliação.

5. Clique em Próxima.

6. Clique em Criar avaliação.

Depois que você faz upload do arquivo ZIP, a Mainframe Assessment Tool descompacta e processa o código-fonte. A página Avaliações mostra uma nova entrada na tabela para cada recurso descoberto, mostrando o status da avaliação.

• Pendente:a avaliação está aguardando a vez.
• Em andamento:a análise está em andamento.
• Analisado:a avaliação foi concluída.
• Falha:a avaliação não foi concluída.

Se você encontrar erros após importar o arquivo, revise a mensagem de erro diretamente na ferramenta de avaliação do mainframe.

Para conferir mais detalhes sobre o progresso da avaliação de um item, clique no ID de referência ao lado dele na tabela. Isso abre uma página que mostra todas as etapas com o status.

Adicionar arquivos a uma avaliação

Depois de criar uma avaliação, é possível adicionar outros arquivos ZIP a ela. Os arquivos do novo arquivo ZIP são mesclados com os arquivos atuais na avaliação. Se você quiser substituir arquivos, o novo arquivo ZIP precisará incluir os arquivos que você está substituindo com a mesma estrutura de caminho.

Para adicionar arquivos a uma avaliação, 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, encontre a avaliação que você quer modificar e clique em Abrir avaliação.
4. Clique em Adicionar um arquivo.
5. Clique em Selecionar arquivo e escolha um arquivo ZIP que você quer enviar. Só é possível fazer upload de um arquivo por vez.
6. Clique em Adicionar.

Depois de fazer upload dos arquivos, a Mainframe Assessment Tool inicia a análise novamente. Se você substituir arquivos, eles serão reavaliados por completo, e qualquer análise existente para esses arquivos poderá mudar. Durante o reprocessamento, um indicador Obsoleto aparece ao lado dos arquivos que estão sendo reprocessados.

Atualizar detalhes e configurações da avaliação

Depois de criar uma avaliação, você pode atualizar o nome e a descrição dela e modificar as configurações de insights gerados por IA.

Para atualizar os detalhes ou as configurações da avaliação, 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, encontre a avaliação que você quer modificar e clique em Abrir avaliação.
4. Clique em ConfiguraçõesEditar configurações da avaliação.
5. Na etapa Detalhes da avaliação, edite o nome e a descrição e clique em Próxima.
6. Na etapa Configurações de IA, modifique as configurações conforme necessário e clique em Próxima.
7. Na etapa Domínios, clique em Próxima. Não é possível editar domínios depois de criar uma avaliação.
8. Clique em Atualizar avaliação.

Depois que você atualizar as configurações, a Mainframe Assessment Tool vai iniciar a análise novamente.

A seguir

• Saiba como ver e entender os resultados da avaliação.