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:

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

Para fazer upload dos arquivos do aplicativo no Mainframe Assessment Tool, 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 tiverem 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)
    • Configurações do programador para o BMC Control-M

    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 Assessment Tool, 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. Para configurar os modelos do Gemini e o nível de qualidade da avaliação, configure a etapa Modelo e qualidade e clique em Próxima.

    Por padrão, a Mainframe Assessment Tool usa o nível de qualidade Equilibrado recomendado. Para mais informações sobre níveis de qualidade, como escolher um modelo específico e manter os dados na sua região, consulte Escolher modelos e qualidade.

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

    Com os domínios, é possível filtrar e analisar os resultados com base em contextos específicos depois que a avaliação é concluída.

  6. Clique em Próxima.

  7. 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 Mainframe Assessment Tool.

Para ver 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.

Escolher modelos e qualidade

Configure os modelos do Gemini para uma avaliação durante a criação ou edição de uma avaliação. Essas configurações são válidas apenas para essa avaliação.

Por padrão, a ferramenta de avaliação do mainframe otimiza os modelos para cada etapa da avaliação com base no nível de qualidade selecionado. A ferramenta encaminha etapas de raciocínio complexas para modelos mais pesados e etapas mais simples para modelos mais leves.

Selecione um nível de qualidade

Em Otimizar para, selecione um dos seguintes níveis de qualidade:

  • Equilibrado (recomendado): equilibra velocidade e profundidade para a maioria das avaliações. Esse é o nível padrão.
  • Rápido: retorna os resultados mais rápidos usando modelos mais leves.
  • Extensa: maximiza a profundidade da análise usando modelos mais pesados.

Cada nível de qualidade lista os modelos do Gemini usados em cada etapa.

Especificar um único modelo

Para executar todas as etapas de avaliação em um único modelo em vez de otimizar por nível, selecione Usar um modelo específico e escolha uma opção na lista. Cada modelo é rotulado como Disponibilidade geral ou Prévia.

A Mainframe Assessment Tool é compatível com todas as zonas nas regiões da Plataforma de Agentes disponíveis.

Aplicar residência de dados

Por padrão, a Mainframe Assessment Tool encaminha as chamadas de modelo para o local ideal dos modelos selecionados, incluindo a região de avaliação, uma região múltipla ou o endpoint global da plataforma do agente.

Para restringir as chamadas de modelo à região de avaliação e à multirregião associada, ative a opção Manter dados na minha região. Quando essa configuração está ativada, a Mainframe Assessment Tool realiza as seguintes ações:

  • Desativa os níveis de qualidade que exigem um modelo do Gemini que não está disponível na região de avaliação. Esses níveis são rotulados como Não disponível nesta região.
  • Oculta da lista de modelos específicos aqueles que não estão disponíveis na região de avaliação.

Se não houver um modelo compatível disponível na região de avaliação, ela não poderá ser executada com a opção Manter dados na minha região ativada. Para continuar com a avaliação, desative a opção Manter dados na minha região para permitir chamadas de modelo fora da região.

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 precisa 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 desses 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. Opcional: na etapa Detalhes da avaliação, edite o nome e a descrição e clique em Próxima.
  6. Opcional: na etapa Configurações de IA, modifique as configurações conforme necessário e clique em Próxima.
  7. Opcional: na etapa Modelo e qualidade, configure os modelos ou o nível de qualidade e clique em Próxima. Para mais informações, consulte Escolher modelos e qualidade.
  8. Na etapa Domínios, clique em Próxima. Não é possível editar domínios depois de criar uma avaliação.
  9. Clique em Atualizar avaliação.

Depois de atualizar as configurações, a Mainframe Assessment Tool inicia a análise novamente.

A seguir