Nesta página, descrevemos como fazer upload dos arquivos do aplicativo de mainframe para a Mainframe Assessment Tool e criar uma avaliação.
Você pode realizar uma avaliação por conta própria usando fluxos de trabalho de autoatendimento ou pedir ajuda ao Google. Se a avaliação envolver estruturas de base de código complexas (como pré-processadores personalizados ou formatos proprietários), mapeamento de domínio em grande escala, requisitos de implantação personalizados ou estratégia de modernização de ponta a ponta, considere solicitar assistência do Google.
Para receber ajuda, entre em contato com sua equipe de conta ou engenheiro de clientes do Google Cloud ou envie um e-mail para a equipe do Google Mainframe em mainframe@google.com.
Antes de começar
Para se preparar para a avaliação, verifique se você concluiu os seguintes pré-requisitos:
- Configure seu projeto do Google Cloud para a Mainframe Assessment Tool.
- Configurar e acessar a Mainframe Assessment Tool.
- Crie um arquivo ZIP com todos os aplicativos que você quer migrar:
- A Mainframe Assessment Tool 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 em domínios de negócios 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ê também inclua essas dependências. Para ver a lista de linguagens, bancos de dados, monitores de transações e configurações de agendador compatíveis, consulte Linguagens compatíveis.
- Não inclua binários e outros arquivos que não sejam de origem no arquivo ZIP.
Criar uma avaliação
Para fazer upload do arquivo ZIP e criar uma avaliação na Mainframe Assessment Tool, siga estas etapas:
Detalhes da avaliação
Para abrir a Mainframe Assessment Tool na máquina local, abra uma janela do navegador da Web e acesse
http://localhost:PORT.Substitua
PORTpelo número da porta que você usou na máquina local para a conexão em túnel com o Mainframe Assessment Tool.Na página Início, clique em Criar avaliação.
Em Nome, insira um nome para a avaliação.
Opcional: em Descrição, insira uma descrição para a avaliação.
Para fazer upload de um arquivo ZIP, clique em Selecionar arquivo. O navegador de arquivos será aberto. Selecione um arquivo ZIP para fazer upload. Você só pode fazer upload de um arquivo por vez.
Clique em Próxima.
Insights de IA
- Opcional: para ativar os insights de IA na avaliação, selecione Ativar insights de IA.
- Para gerar resumos de parágrafos para o código COBOL, selecione Resumos detalhados. Essa opção fica selecionada por padrão.
- 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.
Para extrair informações sobre bancos de dados e arquivos acessados pelo aplicativo, selecione Fontes de dados.
Opcional: em Orientações adicionais de geração, insira orientações em texto livre para adicionar aos comandos do Gemini durante a geração de IA.
Clique em Próxima.
Modelo e qualidade
Configure os modelos do Gemini para a avaliação. Essas configurações se aplicam apenas a esta avaliação.
Selecione como a Mainframe Assessment Tool encaminha as etapas de avaliação para os modelos do Gemini:
- Rápido: retorna os resultados mais rápidos usando modelos mais leves.
- Equilibrado (recomendado): equilibra velocidade e profundidade para a maioria das avaliações, encaminhando etapas de raciocínio complexas para modelos mais pesados e etapas mais simples para modelos mais leves. Essa é a opção padrão.
Estendida: maximiza a profundidade da análise usando modelos mais pesados.
Usar um modelo específico: executa todas as etapas de avaliação em um único modelo, em vez de otimizar por nível. Selecione um modelo na lista. Cada modelo é rotulado como Disponibilidade geral ou Pré-lançamento.
Cada nível de qualidade lista os modelos do Gemini usados para cada etapa. A Mainframe Assessment Tool é compatível com todas as zonas nas regiões da Plataforma de Agentes disponíveis.
Opcional: para restringir as chamadas de modelo à região de avaliação e à multirregião associada, ative Manter dados na minha região.
Por padrão, o Mainframe Assessment Tool encaminha as chamadas de modelo para o local ideal para os modelos selecionados, incluindo a região de avaliação, uma multirregião ou o endpoint global do Agent Platform. 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 os modelos da lista de modelos específicos que não estão disponíveis na região de avaliação.
Se nenhum modelo compatível estiver disponível na região de avaliação, a avaliação 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.
Se a instância da ferramenta de avaliação de mainframe não tiver um endereço IP externo e você ativar a opção Manter dados na minha região, os modelos disponibilizados apenas em um endpoint multirregional poderão ficar indisponíveis. Isso acontece porque o Acesso privado do Google não consegue acessar endpoints multirregionais. Para disponibilizar esses modelos e aderir aos requisitos de residência de dados, configure a conectividade privada com o endpoint multirregional. Para instruções, consulte Configurar a conectividade privada para residência de dados.
Clique em Próxima.
Opcional: domínios
Opcional: para adicionar um ou mais domínios que representam uma área de funcionalidade distinta, clique em Adicionar domínio.
Os domínios permitem filtrar e analisar os resultados com base em contextos específicos após a conclusão da avaliação.
Clique em Próxima.
Criar avaliação
- 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 exibe 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 depois de importar o arquivo, consulte a mensagem de erro diretamente no 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.
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:
- Abra a Mainframe Assessment Tool em um navegador da Web.
- No menu de navegação, clique em Avaliações.
- Na página Avaliações, encontre a avaliação que você quer modificar e clique em Abrir avaliação.
- Clique em Adicionar um arquivo.
- Clique em Selecionar arquivo e escolha um arquivo ZIP para fazer upload. Você só pode fazer upload de um arquivo por vez.
- Clique em Adicionar.
Depois que você fizer o upload dos arquivos, a Mainframe Assessment Tool vai iniciar a análise novamente. Se você substituir arquivos, eles serão totalmente reavaliados, e qualquer análise existente para esses arquivos poderá mudar. Durante o reprocessamento, um indicador Desatualizado aparece ao lado dos arquivos que estão sendo reprocessados.
Atualizar detalhes e configurações da avaliação
Depois de criar uma avaliação, é possível atualizar o nome e a descrição dela, além de modificar as configurações de insights gerados com IA.
Para atualizar os detalhes ou as configurações da avaliação, siga estas etapas:
- Abra a Mainframe Assessment Tool em um navegador da Web.
- No menu de navegação, clique em Avaliações.
- Na página Avaliações, encontre a avaliação que você quer modificar e clique em Abrir avaliação.
- Clique em Configurações Editar configurações de avaliação.
- Opcional: na etapa Detalhes da avaliação, edite o nome e a descrição e clique em Próxima.
- Opcional: na etapa Insights de IA, modifique as configurações de IA conforme necessário e clique em Próxima.
- Opcional: na etapa Modelo e qualidade, configure os modelos ou o nível de qualidade e clique em Próxima.
- Na etapa Domínios (opcional), clique em Próxima. Não é possível editar domínios depois de criar uma avaliação.
- Clique em Atualizar avaliação.
Depois que você atualizar as configurações, a Mainframe Assessment Tool vai reiniciar a análise.
A seguir
- Saiba como analisar e entender os resultados da avaliação.