As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Transformação de aplicativos de mainframe
AWS O Transform acelera a transformação de seus aplicativos de modernização de mainframe. Este tópico descreve os recursos disponíveis.
Tópicos
Pré-requisito: preparar as entradas do projeto no S3
AWS O Transform é capaz de lidar com bases de código complexas de mainframe. Para usar a base de código, verifique se você tem todos os ativos em sua localização do S3.
Principais insumos do projeto:
-
Código-fonte: você deve fazer o upload dos arquivos de código-fonte do mainframe para o S3. Isso inclui programas COBOL, scripts JCL, cadernos e quaisquer outros arquivos de origem relevantes.
-
Arquivos de dados: se você tiver arquivos VSAM ou outros arquivos de dados que seus aplicativos de mainframe usam, eles precisam ser enviados para o S3.
-
Arquivos de configuração: inclua arquivos de configuração específicos para seu ambiente de mainframe.
Outros insumos do projeto
Registros do System Management Facility (SMF): se aplicável, carregue os registros SMF em uma nova pasta no bucket do S3 em que o código-fonte está armazenado. Esses registros devem estar em formato de arquivo.zip.
Formatação: para geração de documentação técnica, você pode aproveitar um arquivo de configuração opcional para gerar documentos PDF alinhados aos formatos e padrões necessários, incluindo cabeçalhos, rodapés, logotipos e informações personalizadas.
Glossário: O AWS AWS Transform Transform aproveita a automação com IA generativa para geração de documentação e extração de regras de negócios. Incluir um arquivo CSV de glossário com informações sobre abreviações e terminologias importantes no diretório raiz do arquivo zip ajudará a melhorar a qualidade da documentação gerada.
Dados de teste: se disponíveis, faça upload de conjuntos de dados de teste que possam ser usados para validar o aplicativo modernizado. Esses dados devem ser armazenados em uma nova pasta no bucket do S3 em que o código-fonte está armazenado.
Detalhes sobre as contribuições do projeto podem ser encontrados aqui.
Sign-in e criar um emprego
Para entrar na experiência web do AWS Transform, siga todas as instruções na Conceitos básicos de AWS Transformação seção da documentação.
Para criar e iniciar um trabalho: siga as etapas em Iniciar seu projeto.
Crie um espaço de trabalho: nomeie e descreva seu espaço de trabalho onde trabalhos, colaboradores e artefatos associados serão armazenados.
Criar trabalho: crie um trabalho selecionando planos de trabalho pré-configurados ou personalize o plano de trabalho com base em seu objetivo selecionando na lista de recursos suportados.
Importante
AWS O Transform recusará suas operações se você não tiver as permissões adequadas. Por exemplo, um colaborador não pode cancelar a transformação de uma tarefa de aplicativos de mainframe nem excluir uma tarefa. Somente um administrador pode executar essas funções.
Ao criar seu trabalho, você pode selecionar entre os recursos abaixo, mas a etapa inicial é sempre necessária, pois é onde está localizada a localização do código-fonte do projeto. No primeiro trabalho configurado em um espaço de trabalho, você deve configurar um conector para seu bucket Amazon S3.
Acompanhando o progresso da transformação
Você pode acompanhar o progresso da transformação em todo o processo de duas maneiras:
-
Registro de trabalho — fornece um registro detalhado das ações que o AWS Transform realiza, junto com as solicitações de entrada humana e suas respostas a essas solicitações.
-
Painel — fornece um resumo de alto nível da transformação do aplicativo de mainframe. Ele mostra métricas sobre o número de trabalhos transformados, a transformação aplicada e o tempo estimado para concluir a transformação dos aplicativos de mainframe. Você também pode ver detalhes de cada etapa, incluindo linhas de código por tipo de arquivo, documentação gerada por cada tipo de arquivo, código decomposto e plano de migração.
Configurar um conector
AWS O Transform usa um conector para acessar os recursos em sua conta necessários para as funções de modernização do mainframe. Seu conector é configurado automaticamente com a primeira tarefa que você executa no espaço de trabalho. Dependendo do plano de trabalho escolhido, o AWS Transform orienta você na criação do seu conector.
Conector de reimaginação de mainframe
O conector de reimaginação do mainframe é para trabalhos que executam os fluxos de trabalho de avaliação e reimaginação. Ele usa um bucket S3 para acessar e armazenar recursos de transformação, bem como um cluster Amazon Neptune para armazenar artefatos extraídos. O cluster Neptune serve como o gráfico de conhecimento unificado que armazena todos os artefatos extraídos sobre seu trabalho, e o gráfico de conhecimento responde a todas as perguntas na interface de bate-papo do Transform. AWS
Implante o cluster Amazon Neptune em uma VPC em AWS que o Transform possa criar interfaces de rede elásticas (ENIs). Essas são as conexões de rede que permitem que o AWS Transform se comunique com segurança com o Neptune em sua VPC para carregar dados e consultar seu gráfico de conhecimento.
AWS CloudFormation
Recomendamos usar o CloudFormation modelo a seguir para criar os recursos necessários para seu mainframe reimagine o conector. Use o mesmo bucket do S3 que você planeja usar para o conector ao executar o CloudFormation modelo. Para obter mais informações sobre o uso CloudFormation de modelos, consulte Como trabalhar com modelos.
Para baixar o CloudFormation modelo, escolha neptune-kg-setup.yaml
O modelo aceita os seguintes parâmetros:
BucketName – obrigatório. Nome do bucket S3 para acesso ao carregador em massa Neptune. Você deve usar o mesmo bucket S3 que planeja usar no seu conector AWS Transform.
KmsKeyId: opcional. Chave KMS para criptografia Neptune. Aceita ID da chave, ARN, nome do alias ou ARN do alias. O padrão é a chave AWS gerenciada, se omitida.
Forneça os seguintes detalhes ao configurar seu conector:
ARN do bucket do S3
ARN do cluster Neptune
ID do recurso do cluster Neptune
IDs de sub-rede do aplicativo
ID do grupo de segurança do aplicativo
Função ARN do carregador em massa Neptune S3
Importante
A guia Saídas do CloudFormation modelo inclui os detalhes que você precisa fornecer ao AWS Transform ao configurar o conector.
Configuração personalizada
Se você preferir usar uma VPC existente ou outras ferramentas para criar a infraestrutura necessária, seu ambiente deve atender aos seguintes requisitos:
Aglomerado de Netuno
-
Amazon Neptune Serverless com motor versão 1.4.5.1 ou posterior
Autenticação IAM ativada
Criptografia de armazenamento ativada (chave AWS gerenciada ou chave KMS gerenciada pelo cliente)
Configuração de escalabilidade sem servidor (recomendada: 1—128 NCUs)
(Recomendado) Leia a réplica em uma segunda zona de disponibilidade para alta disponibilidade e melhor desempenho de leitura
Redes
Uma VPC com suporte a DNS e nomes de host DNS habilitados
Pelo menos duas sub-redes em zonas de disponibilidade separadas. AWS O Transform cria ENIs nessas sub-redes para acessar o cluster Neptune, que pode residir nas mesmas sub-redes ou em sub-redes dedicadas. Dimensione as sub-redes em /20 para acomodar ENIs de aplicativos e endpoints de VPC.
-
Conectividade de rede das sub-redes com os seguintes AWS serviços por meio de endpoints () da interface VPC:AWS PrivateLink
AWS API Transform Agents — coordena os trabalhos de modernização do mainframe
Amazon Bedrock Runtime — invoca modelos básicos para análise e raciocínio
Amazon Relational Database Service (Amazon RDS) — Gerenciamento de clusters do Neptune
Amazon Elastic Compute Cloud (Amazon EC2) — Gerenciamento de ENIs
Amazon CloudWatch — Métricas para a observabilidade do AWS Transform
Um endpoint do gateway S3 conectado às tabelas de rotas associadas às suas sub-redes. AWS O Transform usa esse endpoint para carregar dados do bucket do S3 para o cluster Neptune.
Grupos de segurança
Os grupos de segurança são anexados às ENIs, não às sub-redes. Mesmo quando o AWS Transform ENIs e o Neptune residem na mesma sub-rede, grupos de segurança separados controlam o acesso entre eles.
-
Um grupo de segurança (anexado aos ENIs criados pelo AWS Transform) que permite:
TCP 8182 de saída para o grupo de segurança Neptune
TCP 443 de saída para alcançar endpoints de VPC
-
Um grupo de segurança (anexado ao cluster Neptune) que permite:
TCP 8182 de entrada do grupo de segurança do aplicativo
-
Um grupo de segurança de endpoint VPC (anexado ao endpoint de interface ENiS) que permite:
TCP 443 de entrada do grupo de segurança do aplicativo
IAM
Uma função do IAM com uma política de confiança para
rds.amazonaws.com.rproxy.goskope.comessas concessõess3:GetObjectes3:GetBucketLocationem seu bucket do S3s3:ListBucketEssa função deve estar associada ao cluster Neptune para carregamento em massa de dados do gráfico de conhecimento
O diagrama a seguir mostra a arquitetura recomendada.
Conector S3
Para trabalhos com um plano personalizado, o AWS Transform pode usar um conector S3. O conector S3 usa um bucket S3 para acessar e armazenar recursos de transformação e um bucket vetorial S3 para saída indexada.
Importante
Seus dados são armazenados e persistem no armazenamento de artefatos AWS Transform em seu espaço de trabalho e são usados somente para executar o trabalho.
Configuração opcional do bucket vetorial S3.
Nas regiões em que os compartimentos vetoriais do S3 estão disponíveis, o AWS Transform armazenará codificações vetoriais pesquisáveis da saída do trabalho nesse intervalo vetorial do S3 em sua conta para fornecer uma experiência de pesquisa e bate-papo com inteligência artificial. Os dados não são usados fora desse trabalho e não são usados para treinar modelos. Para habilitar isso, você deve criar e fornecer um bucket vetorial S3. AWS O Transform cria e anexa automaticamente uma função com as permissões necessárias para gravar nesse bucket.
Permissões CORS do bucket S3
Depois que seu conector estiver configurado, adicione a seguinte política de CORS ao seu bucket do S3 para que você possa visualizar e comparar artefatos diretamente no console do AWS Transform. Se essa política não estiver configurada corretamente, talvez você não consiga usar as funcionalidades de visualização em linha ou comparação de arquivos do AWS Transform.
[ { "AllowedHeaders": [], "AllowedMethods": [ "GET" ], "AllowedOrigins": [ "https://*.transform.eu-central-1.on.aws", "https://*.transform.ap-south-1.on.aws", "https://*.transform.ap-northeast-1.on.aws", "https://*.transform.ap-northeast-2.on.aws", "https://*.transform.ap-southeast-2.on.aws", "https://*.transform.ca-central-1.on.aws", "https://*.transform.eu-west-2.on.aws", "https://*.transform.us-east-1.on.aws", "https://*.transform.sa-east-1.on.aws" ], "ExposeHeaders": [], "MaxAgeSeconds": 0 } ]
Avalie e reinvente o plano de trabalho
O plano de trabalho Avaliar e reimaginar é um fluxo de trabalho predefinido para modernizar aplicativos de mainframe. Ele orienta você em duas fases: avaliar sua base de código para identificar funções de negócios e reimaginar as funções que você seleciona. Para escolher capacidades individuais em vez disso, use o plano de trabalho personalizado.
Avaliar
As jornadas de modernização do mainframe geralmente começam com a avaliação da base de código para identificar conteúdos e entender relacionamentos e dependências. Após essa avaliação, você pode começar a decompor e selecionar partes do código-fonte para modernizar. Os limites da decomposição são determinados com base nas funções de negócios.
O catálogo de funções de negócios decompõe sua base de código em funções comerciais distintas, que são construídas sobre uma base de caminhos de dados determinísticos que mapeiam cada função comercial do início ao fim. Um caminho de dados é a rota que os dados seguem, começando com um gatilho de negócios até a gravação final no código do mainframe. Em vez de limitar a análise a um único ponto de entrada, o sistema abrange trabalhos em lote, transações do CICS e seus armazenamentos de dados compartilhados para identificar unidades coerentes de trabalho comercial.
Uma função comercial é um conjunto de trabalho que começa com um gatilho comercial e termina com um resultado comercial mensurável. AWS O Transform fornece um catálogo de funções de negócios nas quais uma linha de negócios pode atuar, permitindo decisões informadas sobre o que modernizar primeiro.
Benefícios de avaliar sua base de código para se modernizar usando funções de negócios:
Full-estate visibilidade — entenda como seus trabalhos em lotes, transações on-line e armazenamentos de dados se conectam a funções significativas para sua empresa.
Limites acionáveis — Cada função comercial identificada é uma unidade independente que as partes interessadas da linha de negócios podem revisar e priorizar para o esforço de modernização.
Consistência do código à especificação — Os mesmos blocos de código que definem uma função de negócios são usados para gerar suas especificações, sem camada de tradução e sem necessidade de reconciliação.
Tempo de descoberta reduzido — A detecção automatizada substitui meses de entrevistas manuais de conhecimento tribal por análises sistemáticas e repetíveis.
Resultados da avaliação fornecidos por meio do chat
Os resultados da avaliação fornecidos pelo chat incluem uma lista de funções de negócios, incluindo o número de caminhos de dados, o que cada função abrange em termos de transações em lote e do CICS e uma descrição da empresa. Você recebe um link para os artefatos gerados no bucket do Amazon S3 e também pode acessá-los por meio do chat. Dois artefatos são fornecidos: detalhes da função comercial e resumo da função comercial.
Resumo da função comercial — fornece uma lista das funções de negócios e uma descrição em linguagem natural das funções que os elementos do código estão executando.
Detalhes da função comercial — fornece um gráfico interativo que mostra as relações entre o código-fonte.
Para interagir com o gráfico, selecione um elemento para mostrar detalhes adicionais sobre ele ou abra um elemento para interrogar seus detalhes. Em cada página, há um resumo de todos os elementos desse nível e uma interface gráfica para interagir e aprender mais sobre cada componente, incluindo o seguinte:
-
Função comercial — Descreve quais funções de negócios estão conectadas entre si e fornece uma visão geral de cada função comercial. Quando você seleciona uma função comercial, as seguintes informações são fornecidas:
Número de caminhos de dados
Número de linhas de código
Descrição da empresa: uma visão geral da função comercial que descreve, em linguagem natural, quais funções os elementos do código estão executando.
Interfaces: detalha como os elementos de dados dentro da função de negócios se relacionam (por exemplo, troca ou gravação).
-
Detalhes da função comercial — descreve as conexões entre os caminhos de dados em uma única função comercial, permitindo que você se aprofunde na composição da função comercial. Ao selecionar um elemento, você vê como esse elemento se conecta à função comercial, junto com os seguintes detalhes:
Datastore: escritores e leitores para o armazenamento de dados.
Outros elementos: uma visão geral do caminho de dados relacionado que descreve, em linguagem natural, as ações e os resultados tratados no caminho de dados, uma lista de programas e leitores e escritores.
-
Caminhos de dados — descreve os detalhes de um caminho de dados e como os elementos dentro do caminho de dados se relacionam entre si.
Descrição: uma visão geral do caminho de dados que descreve, em linguagem natural, as ações e os resultados tratados dentro do caminho de dados.
-
Conteúdo do caminho de dados:
Ponto de entrada
Leituras
Gravações
Programas
Por meio do bate-papo, você pode interrogar os resultados para entender os elementos contidos em cada função comercial e explorar os limites por meio do gráfico da função comercial.
Depois de identificar os limites de sua modernização, o chat solicita que você selecione as funções de negócios que você deseja reimaginar. Você pode selecionar uma única função comercial ou várias funções comerciais. AWS O Transform envia os limites selecionados e os resultados de avaliação necessários para o fluxo reimaginado para continuar a jornada de modernização.
Depois de concluir sua primeira modernização, você pode usar o chat para selecionar um conjunto adicional de funções de negócios para modernizar.
Reimagine
Na fase de reimaginação, você pode selecionar uma ou todas as funções de negócios que a avaliação identificou e prepará-las para a modernização. Isso aciona a extração da lógica de negócios seguida pela geração de requisitos para as funções comerciais selecionadas. Os requisitos gerados são a principal entrada para a engenharia avançada, traduzindo a compreensão do sistema legado em uma especificação precisa do que o aplicativo modernizado deve oferecer.
Extraia a lógica de negócios
Depois de selecionar uma ou mais funções comerciais, o AWS Transform começa a gerar a lógica de negócios para as funções comerciais selecionadas. Após a conclusão da extração, o AWS Transform armazena os resultados em um bucket do Amazon S3 no formato JSON para uso posterior. Você pode monitorar o progresso da extração e analisar quaisquer problemas diretamente no console do AWS Transform.
Para revisar os resultados da extração da lógica de negócios
-
No painel de navegação esquerdo, escolha a etapa Extrair lógica comercial para expandi-la.
-
Veja o seguinte nos detalhes da etapa:
Link do bucket S3: o local em que os resultados da lógica de negócios extraídos são armazenados no formato JSON.
Problemas: uma lista de todos os problemas encontrados durante o processo de extração da lógica de negócios.
Se algum arquivo tiver problemas durante a extração, os seguintes detalhes serão exibidos para cada arquivo afetado:
Nome do arquivo: o nome do arquivo que encontrou um problema.
Tipo de arquivo: o tipo do arquivo (por exemplo, COBOL ou JCL).
Caminho do arquivo: a localização do arquivo em seu aplicativo.
Status: O status atual da extração do arquivo.
Detalhes: uma descrição do problema encontrado.
nota
Após a conclusão da etapa de extração, o AWS Transform começa automaticamente a gerar requisitos. Você não será solicitado a fornecer nenhuma entrada adicional antes do início desse processo.
Gere requisitos
Após a conclusão da extração da lógica de negócios, o agente Generate Requirements consome os artefatos extraídos (análise de código, análise de dados, regras de negócios) e produz requisitos de modernização. Esses requisitos são especificações funcionais formais que são independentes de tecnologia e incluem critérios de aceitação testáveis. AWS O Transform produz um requirements.md arquivo para cada função comercial que você seleciona e armazena a saída em um bucket do Amazon S3. Para visualizar a localização da saída no Amazon S3, escolha a etapa Gerar requisitos.
Cada requirements.md arquivo é organizado nas seguintes partes:
-
Título — Nomeia a função comercial e o fluxo de trabalho que ela representa.
-
Condições prévias globais — condições que devem ser válidas em todo o fluxo de trabalho antes e durante o processamento. Os valores configuráveis aparecem como espaços reservados para parâmetros.
-
Seções numeradas do fluxo de trabalho — Cada seção representa um estágio distinto da função comercial. Cada seção contém o seguinte:
Uma história de usuário que declara a meta como uma função, a ação que a função deseja realizar e o resultado resultante.
Uma lista de requisitos no formato EARS (Easy Approach to Requirements Syntax), cada um com um identificador exclusivo.
nota
A seleção de um segundo conjunto de funções de negócios reinicia a etapa de reimaginação das funções recém-selecionadas. O console então mostra os resultados somente para a nova seleção, portanto, quaisquer problemas com as regras de negócios de suas funções comerciais anteriores e os links do Amazon S3 que armazenam as saídas para a lógica e os requisitos de negócios não são mais exibidos. Suas saídas anteriores não foram perdidas. Você ainda pode acessá-los na guia Artifacts ou em seu bucket do Amazon S3.
Rastreabilidade entre artefatos de transformação
AWS O Transform mantém a rastreabilidade entre os artefatos que gera em todo o fluxo de trabalho de avaliação e reimaginação. A rastreabilidade permite rastrear cada requisito de acordo com as regras de negócios extraídas ou diretamente com o código-fonte original que produziu o requisito.
Você pode visualizar todos os detalhes de rastreabilidade de cada função comercial usando o traceability.yaml arquivo. Ela descreve como cada regra de negócios se relaciona com um requisito.
Para rastreabilidade interativa, você pode usar o plug-in IDE nos editores compatíveis com VS Code e Open VSX. Para obter mais informações, consulte Ferramentas para desenvolvedores.
Reinvente o plano de trabalho
Para aplicativos que você tem como escopo a modernização e está pronto para reimaginar, você pode executar um trabalho de reimaginação independente. O trabalho analisa seu código e dados, extrai a lógica de negócios, identifica domínios de negócios e gera requisitos de modernização para cada domínio comercial.
Plano de trabalho personalizado
Um plano de trabalho personalizado permite que você crie seu próprio fluxo de trabalho de modernização selecionando os recursos que você deseja executar. Ele oferece controle total sobre quais recursos estão incluídos. Escolha entre os seguintes recursos com base em seu objetivo de modernização. Alguns recursos dependem de outros serem executados primeiro. Por exemplo, a análise de código é necessária para a maioria dos outros recursos.
Analise o código
Depois de compartilhar o caminho do bucket do Amazon S3 com o AWS Transform, ele analisará o código de cada arquivo com detalhes como nome do arquivo, tipo de arquivo, linhas de código e seus caminhos.
nota
Você pode baixar os resultados do código Analyze por meio da guia de artefatos no nível do trabalho ou do espaço de trabalho. No nível do trabalho, vá até a opção 'Artefatos' no menu de navegação esquerdo e abra a pasta 'resultados' ou, no nível do espaço de trabalho, encontre o nome do trabalho e abra a pasta 'resultados'. Isso fará o download de um arquivo zip que contém o arquivo de classificação para o fluxo de trabalho de classificação manual, a lista de ativos, o arquivo JSON de dependências e a lista de arquivos ausentes.
No plano de trabalho, selecione Analisar código no painel de navegação esquerdo para ver seus resultados. Você pode visualizar os resultados da análise de código de várias maneiras:
-
Visualização em lista — Todos os arquivos no bucket do Amazon S3 que você deseja transformar para mainframe
-
Visualização do tipo de arquivo — Todos os arquivos no bucket do Amazon S3 exibidos por tipo de arquivo. Para obter uma lista dos tipos de arquivo compatíveis, consulte Arquivos compatíveis.
-
Visualização de pastas — Todos os arquivos no bucket do Amazon S3 exibidos na estrutura de pastas.
Nos resultados do arquivo, o AWS Transform fornece as seguintes informações, dependendo da visualização de arquivo escolhida:
-
Nome
-
Tipo de arquivo
-
Total de linhas de código
-
Caminho do arquivo
-
Linhas de comentários
-
Linhas vazias
-
Linhas de código eficazes
-
Número de arquivos
-
Complexidade ciclomática - A complexidade ciclomática representa o número de caminhos linearmente independentes através do código-fonte de um programa. AWS A transformação mostrará uma complexidade ciclomática para cada um dos arquivos.
Arquivos ausentes — Arquivos ausentes da análise do código de modernização do mainframe. Idealmente, esses arquivos devem ser adicionados como parte da entrada de origem no bucket do Amazon S3, e a etapa de análise deve ser executada novamente para obter resultados melhores e coesos.
Nome idêntico — AWS Transform fornece uma lista de arquivos que compartilham o mesmo nome e, possivelmente, as mesmas características (por exemplo, número de linhas de código). Ele não poderá comparar a diferença entre o conteúdo de dois arquivos ao mesmo tempo.
IDs duplicados — Com o programa Cobol, o campo ID do programa serve como o identificador exclusivo do arquivo. Esse ID deve ser exclusivo porque é usado para chamar o programa em todo o projeto. No entanto, alguns projetos podem ter arquivos COBOL com nomes diferentes, mas com o mesmo ID do programa. Obter a lista desses arquivos durante a avaliação pode ajudar a entender as dependências entre todos os programas.
nota
Isso é específico para códigos e arquivos COBOL.
Quando você tem programas com IDs duplicados, é recomendável alterar os IDs de programa desses arquivos para ter um identificador exclusivo para cada um deles no código COBOL. Em seguida, você pode executar novamente seu trabalho para obter resultados de análise de código mais precisos e abrangentes.
Ao resolver IDs de programa duplicados, você pode:
-
Melhore a clareza e a capacidade de manutenção do código
-
Reduza possíveis conflitos nas chamadas do programa
-
Melhore a precisão do mapeamento de dependências
-
Simplifique os esforços futuros de modernização
Problemas na base de código — Possíveis problemas detectados na base de código que você deve resolver antes de continuar com o projeto de modernização. Esses problemas podem incluir referências ausentes com declarações associadas ou links sem suporte no código.
Classificação de atualização — Com a reclassificação manual, você pode reclassificar arquivos usando o recurso de atualização em massa fazendo o upload do arquivo JSON com a nova classificação.
Importante
Isso só está disponível para TXT arquivos UNKNOWN e.
Após a reclassificação, AWS o Transform irá:
-
Atualiza os resultados da classificação
-
Re-runs análise de dependências com os novos tipos de arquivo
-
Atualiza todos os resultados de análise afetados
nota
Você pode reclassificar arquivos somente após a conclusão do ciclo de análise inicial.
Visualizador embutido e comparação de arquivos
O visualizador embutido é um recurso do AWS Transform for mainframe que fornece dois recursos principais de visualização:
-
Visualização do arquivo: visualize o conteúdo dos arquivos herdados selecionados das tarefas
-
Comparação de arquivos: compare o conteúdo de dois arquivos legados lado a lado
Visualização do arquivo de entrada
Para visualizar seus arquivos no Analise o código step (etapa)
-
Em Exibir resultados da análise de código, selecione um arquivo usando a caixa de seleção na lista.
Escolha o botão Exibir ação (ativado quando 1 item é selecionado).
O conteúdo do arquivo será renderizado na tela no componente Exibição de arquivo.
Comparação de arquivos
Para comparar arquivos no Analise o código step (etapa)
-
Em Exibir resultados da análise de código, selecione dois arquivos usando as caixas de seleção na lista.
-
Escolha o botão de ação Comparar (ativado somente quando 2 itens são selecionados).
-
Os arquivos serão exibidos lado a lado no componente de comparação de arquivos.
nota
Você não pode selecionar mais de dois arquivos para comparar arquivos.
Importante
Se você estiver tendo problemas com o visualizador embutido ou com a comparação de arquivos, verifique se o bucket do S3 está configurado corretamente. Para obter mais informações sobre a política CORS do bucket S3, consulte. Permissões CORS do bucket S3
Análise de dados
AWS O Transform fornece análise de dados para ajudar a entender o impacto das relações e dos elementos de dados no projeto de modernização do mainframe. As duas saídas fornecidas são:
Linhagem de dados: rastreia o ciclo de vida dos dados mapeando as relações entre fontes de dados, trabalhos e programas
Dicionário de dados: serve como um repositório que documenta os metadados estruturais dos elementos de dados legados
Após a conclusão da análise, haverá duas guias presentes para cada saída e, em seguida, várias visualizações disponíveis descritas abaixo para a linhagem de dados e o dicionário.
nota
Quando você solicita a análise de dados. AWS O Transform realiza a análise de código, necessária para realizar a análise de dados.
Linhagem de dados
AWS O Transform fornece várias visualizações com base nas relações de dados que precisam ser entendidas em toda a base de código que está sendo modernizada. As quatro visualizações de tabela disponíveis na linhagem de dados incluem:
-
Conjuntos de dados: essa visualização fornece uma análise de impacto abrangente, incluindo rastreamento de operações para ajudar a distinguir entre leitura, gravação, atualização e exclusão
-
Tabelas do Db2: forneça a análise de impacto relacionada às tabelas e às operações do Db2
-
Program-to-data: identifique quais programas COBOL fazem referência a cada conjunto de dados
-
JCL-to-data relacionamentos: identifique quais scripts JCL fazem referência a cada conjunto de dados
O resumo fornece uma visão geral das fontes de dados e suas relações com programas e JCLs, bem como informações resumidas sobre como as fontes de dados são aproveitadas e o total de operações encontradas na base de código.
Dicionário de dados
Compreender os elementos de dados nas fontes de dados presentes na base de código é a próxima etapa para perceber como as várias fontes de dados são dependentes. O dicionário de dados é um catálogo de dados que fornece metadados em nível de campo com descrições de linguagem comercial para um mapeamento preciso da transformação.
-
Estrutura de dados COBOL: fornece informações de campo em cadernos COBOL e referências INLINE presentes na base de código, incluindo propriedades de campo e definição de negócios
-
Tabelas Db2: Fornece propriedades de colunas e tabelas em todas as tabelas Db2 presentes na base de código, incluindo chaves primárias e estrangeiras, informações de esquema e índice e tipos de dados
A relação entre a linhagem de dados e o dicionário está disponível selecionando a fonte de dados e, em seguida, utilizando o botão de linhagem de dados ou dicionário de dados para aprofundar a relação entre a fonte de dados e os elementos de dados. A navegação entre a linhagem de dados e o dicionário fornece visibilidade de dados integrada com a linhagem de dados fornecendo o “quê” - estrutura e significado, juntamente com o “onde” - uso e relacionamento.
Análise de métricas de atividade
A análise de métricas de atividade permite analisar registros do System Management Facility (SMF) do tipo 14, 15, 30, 64, 102 e 110. A análise fornece informações sobre como os elementos são usados em seu aplicativo de mainframe. Ele pode ajudar na remoção de código não utilizado ou na tomada de decisões sobre a arquitetura de destino do aplicativo modernizado. Se você incluir a análise de métricas de atividade em seu trabalho, concluir primeiro a etapa de análise de código fornecerá resultados SMF mais ricos, embora isso não seja obrigatório.
nota
Quando você negocia o plano de trabalho para a modernização do mainframe, concluir primeiro as etapas de análise e decomposição do código fornece resultados mais ricos.
Registros SMF integrados para análise
Você deve fornecer a localização do registro SMF em seu bucket do Amazon S3 como a etapa inicial para a análise SMF. Forneça um mínimo de 13 meses de registros para capturar ocorrências anuais que prazos mais curtos possam perder. Embora 13 meses sejam recomendados, qualquer período de tempo com registros SMF detectáveis produz resultados de análise.
Sua extração SMF deve atender aos seguintes requisitos de formato:
Inclua os tipos 14, 15, 30 (subtipo 5), 64, 102 e 110.
Use um arquivo binário bruto no formato EBCDIC.
Inclua bytes RDW.
Forneça um link para os registros SMF em seu bucket do Amazon S3, garantindo que os registros estejam em uma pasta separada do seu código-fonte. As opções de formato incluem .zip (até 600 MB) ou .tar.gz (até 5 GB) compactado. Se você fornecer um link para uma pasta na qual os registros SMF não foram detectados, você receberá uma mensagem de erro e nenhuma análise será concluída.
Saída de análise
A saída da análise contém dois componentes, dependendo do tipo de registro: uma visualização tabular e uma saída.csv (disponível em seu bucket do Amazon S3). Em AWS Transform, as saídas são exibidas para os tipos 30 e 110. Por meio dos artefatos em seu bucket do Amazon S3, você pode explorar a análise em outros tipos de registros. Na interface do usuário, o cabeçalho exibe o intervalo de tempo dos registros fornecidos para que você possa identificar as datas-chave ausentes. Por exemplo, se seus registros abrangem 1º de maio a 31 de outubro, mas excluem o dia movimentado após o Dia de Ação de Graças, você pode ver que faltam os principais registros. Os carimbos de data/hora no aplicativo web refletem o fuso horário do seu sistema e os registros SMF.
Os artefatos disponíveis no Amazon S3 fornecem análises para qualquer tipo de registro encontrado nos registros fornecidos.
Visualização tabular
A exibição tabular, disponível somente para SMF 30 e 110, contém até três componentes principais para trabalhos em lotes e transações do CICS:
Resumo — Fornece os principais trabalhos e transações.
Análise de job/CICS transações em lote — fornece análise agregada entre trabalhos e transações.
Comparação de análise de código (somente em lote) — Fornece dados de comparação quando a etapa de análise de código é executada antes da análise SMF.
O resumo da descoberta fornece três grupos de trabalhos e transações que ajudam você a identificar rapidamente os itens para uma análise mais profunda.
A análise de tarefas em lotes e transações do CICS fornece análises agregadas entre trabalhos e transações. Algumas colunas nos resultados da análise estão ocultas por padrão. Escolha o ícone de engrenagem para exibir campos adicionais.
A chave de transação gera uma agregação de dados exclusiva para transações do CICS, combinando quatro campos em um único valor de chave:
ID da transação
Nome do programa
SysPlex ID
SysID
Você pode pesquisar pela chave completa ou por qualquer componente da chave na saída da análise.
A comparação da análise de código destaca as tarefas encontradas nos registros SMF ou na etapa de análise do código, mas não estão presentes em ambas. Isso mostra trabalhos que não foram executados durante o período de registro do SMF ou que não estavam presentes na etapa de análise do código. Essa saída está disponível somente quando você executa a etapa de análise de código antes da análise SMF em seu trabalho.
Práticas recomendadas
Para obter resultados abrangentes para trabalhos em lote (tipo 30), certifique-se de que o nome do arquivo JCL corresponda ao nome do trabalho para obter resultados significativos na comparação da análise de código.
Gere documentação técnica
Você pode gerar documentação técnica para seus aplicativos de mainframe que estão passando por modernização. Ao analisar seu código, o AWS Transform pode criar automaticamente uma documentação detalhada de seus programas de aplicativos, incluindo descrições da lógica, fluxos, integrações e dependências do programa presentes em seus sistemas legados. Esse recurso de documentação ajuda a preencher a lacuna de conhecimento, permitindo que você tome decisões informadas ao fazer a transição de seus aplicativos para arquiteturas de nuvem modernas.
nota
Quando você solicita a geração da documentação técnica, o AWS Transform realiza a análise do código, incluindo a análise de dependência do código, que é necessária para gerar a documentação.
Para gerar documentação técnica
-
No painel de navegação esquerdo, em Generate technical documentation, escolha Select files and configure settings.
-
Selecione os arquivos no bucket do Amazon S3 para os quais você deseja gerar documentação e defina as configurações na guia Colaboração.
nota
Os arquivos selecionados devem ter o mesmo tipo de codificação (ou seja, todos no mesmo CCSID - UTF8 ou ASCII). Caso contrário, a documentação técnica gerada pode ter campos ou seções vazios.
-
Escolha o nível de detalhes da documentação:
-
Summary: fornece uma visão geral de alto nível de cada arquivo no escopo. Além disso, fornece um resumo de uma linha de cada arquivo.
-
Detailed functional specification: fornece detalhes abrangentes de cada arquivo no escopo de transformação da aplicação de mainframe. Alguns detalhes incluem lógica e fluxo, dependências, processamento de entrada e saída e vários detalhes da transação.
nota
A documentação só pode ser gerada para arquivos COBOL e JCL.
-
-
Escolha Continuar.
-
Depois que o AWS Transform gerar a documentação, revise os resultados da documentação seguindo o caminho do bucket do Amazon S3 no console, onde os resultados são gerados e armazenados.
-
Depois que a documentação for gerada, você também poderá usar o bate-papo do AWS Transform para fazer perguntas sobre a documentação gerada e decidir as próximas etapas.
Adicione informações do usuário à documentação
ARTIFACT_ID.zip └── app/ ├── File1.CBL ├── File2.JCL ├── subFolder/ │ └ File3.CBL └── glossary.csv └── pdf_config.json ├── header-logo.png ├── footer-logo.png └ ...
Arquivos opcionais podem ser adicionados ao arquivo zip para ajudar a melhorar a qualidade da documentação gerada e fornecer uma capa personalizada em PDF. Alguns deles podem ser:
-
arquivo glossary.csv: você pode optar por fornecer e carregar um glossário opcional no arquivo zip no bucket do S3. O glossário está no formato CSV. Esse glossário ajuda a criar documentação com descrições relevantes de acordo com o vocabulário do cliente. Um
glossary.csvarquivo de amostra se parece com:LOL,Laugh out loud ASAP,As soon as possible WIP,Work in progress SWOT,"Strengths, Weaknesses, Opportunities and Threats" -
pdf_config.json: você pode aproveitar esse arquivo de configuração opcional para gerar documentos PDF alinhados aos formatos e padrões da empresa, incluindo cabeçalhos, rodapés, logotipos e informações personalizadas. Uma amostra
pdf_config.jsonse parece com:{ "header": { "text": "Acme Corporation Documentation", "logo": "header-logo.png" }, "customSection": { "variables": [ { "key": "business Unit", "value": "XYZ" }, { "key": "application Name", "value": "ABC" }, { "key": "xxxxxxxxxx", "value": "yyyyyyyyyyyy" }, { "key": "urls", "value": [ { "text": "Product Intranet Site", "url": "https://example.com/intranet" }, { "text": "Compliance Policies", "url": "https://example.com/policies" } ] } ] }, "footer": { "text": "This document is intended for internal use only. Do not distribute without permission.", "logo": "footer-logo.png", "pageNumber": true } }-
Cabeçalho:
-
Para o arquivo PDF da capa, o texto padrão será o nome do projeto.
-
Para cada arquivo PDF do programa, o texto padrão será o nome do programa.
-
Não há logotipo padrão. Se um logotipo de cabeçalho não estiver configurado, nenhum logotipo será exibido.
-
O tamanho da fonte e o tamanho do logotipo devem ser alterados dinamicamente com base no número de palavras ou no tamanho do arquivo do logotipo.
-
-
Seção personalizada:
-
Se a seção personalizada não estiver configurada, ela será omitida do PDF.
-
O link deve ser clicável.
-
-
Rodapé:
-
Não há texto ou logotipo padrão para o rodapé.
-
O número da página será exibido no rodapé por padrão, a menos que seja explicitamente configurado de outra forma.
-
O tamanho da fonte e o tamanho do logotipo devem ser alterados dinamicamente com base no número de palavras ou no tamanho do arquivo do logotipo.
-
-
Gere um visualizador embutido de documentação
Você pode visualizar os arquivos PDF na etapa de geração da documentação técnica.
Para visualizar os arquivos PDF
-
Navegue até a guia Revisar resultados da documentação.
-
Localize o PDF na tabela que lista os PDFs gerados.
-
Selecione o arquivo e, em seguida, selecione Exibir ou selecione o elemento de link sobreposto ao nome do arquivo.
O PDF é aberto no AWS Transform, com a opção de expandir a tela no canto superior direito.
nota
AWS O Transform também permite baixar uma versão em XML ou PDF da documentação técnica gerada.
Importante
Se você estiver tendo problemas com o visualizador embutido da documentação, verifique se o bucket do S3 está configurado corretamente. Para obter mais informações sobre a política CORS do bucket S3, consulte. Permissões CORS do bucket S3
Extraia a lógica de negócios
Você pode extrair a lógica comercial essencial de seus aplicativos de mainframe que estão passando por modernização. AWS O Transform analisa automaticamente seu código para identificar e documentar elementos comerciais essenciais, incluindo fluxos de processo detalhados e lógica de negócios incorporada em seus aplicativos. Esse recurso atende a várias partes interessadas em sua jornada de modernização. Os analistas de negócios podem aproveitar a lógica extraída para criar requisitos comerciais precisos e identificar lacunas ou inconsistências nas implementações atuais. Os desenvolvedores ganham a capacidade de compreender rapidamente a funcionalidade complexa do sistema legado sem ampla experiência em mainframe.
nota
Quando você solicita a extração da lógica de negócios. AWS O Transform realiza a análise do código, incluindo a dependência do código e a análise do ponto de entrada, que são necessárias para realizar a extração da lógica de negócios.
Para extrair a lógica de negócios
-
No painel de navegação esquerdo, em Extrair lógica comercial, escolha Definir configurações.
-
Na guia Colaboração, selecione como você deseja extrair a lógica de negócios:
Nível do aplicativo: gera documentos comerciais para todas as funções comerciais, transações, trabalhos em lotes e arquivos. Isso seleciona todos os arquivos no aplicativo.
-
Nível do arquivo: gera documentos comerciais somente para arquivos selecionados na tabela de arquivos.
nota
Para qualquer uma das opções, você pode selecionar Incluir especificação funcional detalhada para que o AWS Transform inclua fluxo de controle e regras de negócios abrangentes para os arquivos selecionados.
Os arquivos selecionados devem ter o mesmo tipo de codificação (ou seja, todos no mesmo CCSID - UTF8 ou ASCII). Caso contrário, a documentação gerada pode ter campos ou seções vazios.
-
A documentação só pode ser gerada para arquivos COBOL e JCL.
-
No nível do aplicativo, os programas usados por transações do CICS e trabalhos em lotes são agrupados, enquanto todos os outros programas são categorizados como Não atribuídos.
-
Escolha Continuar.
-
Depois que o AWS Transform extrai a lógica de negócios, ele armazena os resultados em um bucket do Amazon S3 no formato JSON para que você possa visualizá-los on-line.
nota
O número de arquivos de regras de negócios gerados pode ser maior do que sua seleção inicial. Alguns arquivos selecionados podem acionar a extração de regras de negócios para incluir arquivos dependentes adicionais, que também aparecerão na tabela de resultados.
Veja a documentação comercial extraída em linha
Você pode visualizar a lógica de negócios na etapa Extrair regra de negócios. Para fazer isso,
-
Navegue até Revisar os resultados da extração da lógica de negócios.
-
Selecione o documento que você deseja visualizar na tabela e clique no botão Exibir resultado.
A página de documentação comercial é aberta em uma nova guia do navegador.
Decomposição
Você pode decompor seu código em domínios que contabilizam as dependências entre programas e componentes. Isso ajuda os arquivos e programas relacionados a serem agrupados adequadamente no mesmo domínio. Também ajuda a manter a integridade da lógica do aplicativo durante o processo de decomposição.
nota
Quando você solicita a decomposição, o AWS Transform realiza análises de código, incluindo análises de dependência de código, que são necessárias para realizar a decomposição. Também recomendamos que você execute a extração da lógica de negócios antes da decomposição para obter melhores resultados.
Para começar a decompor seu aplicativo:
-
Selecione Decompor código no painel de navegação esquerdo.
nota
Um domínio, Não atribuído, é criado automaticamente para todos os arquivos não associados a um domínio. Na navegação inicial, todos os arquivos devem ser associados a Não atribuído, a menos que os domínios tenham sido propostos a partir da extração da lógica de negócios no nível do aplicativo.
-
Crie um novo domínio por meio do menu Ações e escolha Criar domínio.
-
Em Criar domínio, forneça o nome do domínio, a descrição opcional e marque alguns arquivos como sementes.
-
Os arquivos configurados pelo CICS (CSD) e os arquivos configurados pelo agendador (SCL) podem ser usados para detecção automática de sementes.
-
Você também pode definir um domínio somente como um componente comum. Os arquivos nesse domínio são comuns a vários domínios.
-
-
Escolha Criar.
nota
Você pode criar vários domínios com arquivos diferentes como sementes.
-
Depois de confirmar todos os domínios e sementes, escolha Decompor.
-
AWS O Transform verificará os arquivos do código-fonte e depois se decomporá em domínios com programas e conjuntos de dados com casos de uso semelhantes e altas dependências de programação.
AWS O Transform oferece uma visualização tabular e gráfica dos domínios decompostos como dependências. A visualização gráfica tem três opções:
-
Visualização de domínio — Pode ver como diferentes domínios estão relacionados entre si em formato visual.
-
Visualização de dependências — Pode visualizar todos os arquivos em cada domínio como um gráfico complexo de dependências. Se um nó que foi adicionado a um domínio não recebeu informações de uma semente no mesmo domínio, esse nó será previsto como não atribuído (o nó não recebeu nenhuma informação), desconectado (em um subgráfico que não recebeu informações iniciais) ou em outro domínio (o nó recebeu informações de pelo menos esse domínio).
-
Visualização do subgráfico - O usuário pode criar subgráficos para visualizar um subconjunto de nós para entender mais claramente o impacto relacional e os limites dessa coleção de nós.
-
Para criar um subgráfico, selecione um grupo de nós e selecione a opção Extrair subgráfico na barra de ferramentas.
-
A mesclagem de subgráficos está disponível quando um novo terceiro subgráfico é criado, além dos dois subgráficos que você está mesclando.
-
nota
Repita essas etapas para adicionar mais domínios ou reconfigurar seus domínios já criados com um conjunto diferente de sementes se você não gostar da estrutura de domínio atual.
-
-
Ao concluir, escolha Continuar.
Sementes
As sementes são as entradas fundamentais para a fase de decomposição do código. Cada componente ou arquivo (por exemplo, JCL, COBOL, tabelas Db2, CSD e arquivos do agendador) pode ser atribuído como semente a apenas um domínio, garantindo limites e alinhamento claros durante o processo de decomposição.
A identificação das sementes depende da estrutura da aplicação ou do portfólio. No caso de um aplicativo legado típico de mainframe, as sementes geralmente podem ser determinadas aderindo às convenções de nomenclatura estabelecidas, ao agrupamento em nível de lote no agendador e ao agrupamento em nível de transação definido no sistema CICS. Além disso, as tabelas do banco de dados também podem servir como sementes, fornecendo outra camada de estrutura para decomposição.
Importar arquivos de dependências de and/or atualização
Durante a decomposição, você pode carregar um arquivo JSON para as dependências que substitui os arquivos existentes gerados pela análise de dependências que o Transform executa. AWS
A função de exportação de dependências permite que você baixe o arquivo json de dependências gerado na etapa de decomposição. Após o download, você pode modificar o arquivo de acordo com sua necessidade. Em seguida, você pode importar dependências usando a funcionalidade de upload do AWS Transform, que permite carregar o novo arquivo JSON das dependências que substitui o arquivo gerado pela análise de dependências. Depois disso, o gráfico na etapa de decomposição será atualizado.
Para exportar, modificar e importar dependências
-
Na página Exibir resultados de decomposição, escolha Ações.
-
Na lista suspensa, escolha a opção Atualizar arquivo de dependências em Outras ações.
-
No modal Atualizar dependências do arquivo,
-
Baixe o arquivo de dependência AWS Transform criado a partir dos resultados da análise existente.
-
No arquivo baixado, modifique as dependências com base no que você deseja alcançar.
-
Depois de modificar, salve e carregue esse arquivo usando o botão Carregar arquivo de dependência.
nota
O único formato de arquivo aceito é o arquivo JSON.
-
-
Em seguida, escolha Importar.
AWS O Transform importará o arquivo de dependências e criará um novo gráfico de dependências com base na sua entrada.
Importar domínios de and/or atualização
Para clientes que têm domínios, sementes e relacionamentos de and/or arquivos mapeados antes da etapa de decomposição, você pode carregar essa definição de domínio por meio da função Importar arquivo de domínios, disponível no menu Ações. Alguns exemplos de quando essa função pode ser utilizada:
-
Antecipe a decomposição de outro trabalho
-
Especialistas no assunto que fornecem esse mapeamento
Depois que o arquivo do domínio for importado, o usuário poderá executar a decomposição na definição do domínio ou, se estiver satisfeito, pode salvar e enviar a definição do domínio.
Parent/child/neighbor arquivos
Em um gráfico de dependências, os programas se relacionam entre si por meio de diferentes tipos de conexões. A compreensão dessas relações ajuda você a analisar as dependências do programa durante a transformação de seus aplicativos de mainframe. Também ajuda a entender os limites de um domínio. Por exemplo, se você selecionar um domínio e, em seguida, selecionar um nível principal, ele mostrará os nós conectados.
Relacionamentos com os pais — Um arquivo principal chama ou controla outros programas. Os pais estão acima dos programas dependentes na hierarquia. Você pode selecionar o pai em um nível ou em todos os níveis.
Relacionamentos com filhos — Um arquivo secundário é chamado ou controlado pelo programa principal. Os filhos estão abaixo dos pais na hierarquia de arquivos.
Relações entre vizinhos — Vizinhos são arquivos no mesmo nível hierárquico. Eles compartilham o mesmo programa principal e podem interagir diretamente uns com os outros.
Reforge o código
O Reforge usa modelos de linguagem grande (LLMs) para melhorar a qualidade do código refatorado. A COBOL-to-Java transformação inicial preserva a equivalência funcional enquanto retém estruturas de COBOL-influenced dados e nomes de variáveis do sistema legado. O Reforge reestrutura esse código para seguir práticas e expressões modernas de Java, substituindo COBOL-style construções por coleções Java nativas e convenções de nomenclatura. Isso torna o código mais legível e fácil de manter para desenvolvedores Java.
nota
As cotas para reforma são:
3.000.000 de linhas de código por trabalho
50.000.000 de linhas de código por usuário por mês
Reforje seu código após a refatoração seguindo estas etapas:
Escolha Reforge código java no painel de navegação esquerdo e selecione Configurar código reforge.
Forneça a localização do S3 para seu projeto de código-fonte compilável compactado e escolha Continuar. Use essa estrutura de zíper:
input.zip └── PROJECT-pom ├── PROJECT-entities ├── PROJECT-service ├── PROJECT-tools ├── PROJECT-web (optional) └── pom.xmlAWS O Transform analisa seu pacote zip para localizar arquivos dentro do PROJECT-service diretório para que ele possa fornecer uma lista selecionável de classes que você pode reformar. Essas classes têm o sufixo
ProcessImpl.java.Complete a página Selecionar classes a serem reforjadas e escolha Continuar. Acompanhe o status da reforma na guia Registro de trabalho.
Veja os resultados de sua reforma concluída na página Exibir resultados, que exibe o status da reforma por classe. Ele também especifica onde encontrar o resultado do Reforge em seu bucket do S3.
Depois que o AWS Transform recebe essa entrada de você, ele fornece um arquivo para download com os resultados do Reforge.
Esta é a estrutura zip resultante de uma reforma bem-sucedida:
reforge.zip └── maven_project ├── reforge.log └──tokenizer_map.json
-
maven_project contém o código-fonte reforjado.
-
Os arquivos que foram refatorados, mas cuja compilação não foi finalizada com êxito, estão localizados em e são nomeados.
/src/main/resources/reforge/originalClassName.java.incompleteCompare-os com as versões originais dos arquivos para escolher as funções reforjadas que você deseja salvar.originalClassName.java.incomplete -
Os arquivos de origem fornecidos ao AWS Transform que foram refatorados com sucesso são copiados
src/main/resources/reforge/originalClassName.java.originale nomeados.originalClassName.java.originalAs versões refatoradas dos arquivos substituem os arquivos de origem fornecidos ao Transform. AWS
nota
Os
originalClassName.javaarquivos são substituídos pelos arquivos reforjados somente se o processo de reformulação for bem-sucedido. Caso contrário, eles retêm o conteúdo original. -
-
O reforge.log contém registros que você pode usar para diagnosticar falhas de trabalho ou fornecer AWS suporte em caso de problema.
-
tokenizer_map.json contém um mapeamento de IDs de token para seus dados, como caminhos e class/method nomes de arquivos, que são tokenizados nos registros para proteção de privacidade. Você pode fornecer esse arquivo para AWS suporte em caso de problema.
Planeje seus testes de aplicativos modernizados
Você pode criar e gerenciar planos de teste para seus aplicativos modernizados de mainframe com base nos atributos de código extraídos, na complexidade do trabalho e nos caminhos do agendador. AWS O Transform ajuda a priorizar quais trabalhos testar e identifica os artefatos específicos necessários para cada caso de teste. O processo de planejamento do teste é dividido em três fases principais: configuração, escopo e revisão.
Para criar um plano de teste
-
Definir as configurações do plano de teste
-
No painel de navegação esquerdo, em Planejar seus testes, escolha Definir configurações.
-
(Opcional) Forneça caminhos S3 para sua extração lógica de negócios (BLE). Esses artefatos aprimoram a qualidade do plano de teste. Sem artefatos BLE, alguns campos no plano de teste podem permanecer incompletos.
-
-
Defina o escopo do plano de teste
-
Selecione pontos de entrada, como trabalhos em lotes, para incluir em seu plano de teste.
-
Filtre e classifique trabalhos com base em vários atributos:
-
Funções de negócios (extraídas do BRE BLE)
-
Domínios (da fase de decomposição)
-
Caminhos e localizações de arquivos
-
Critérios de pesquisa personalizados
-
-
Selecione trabalhos individuais ou grupos inteiros para testes.
-
Analise as relações de trabalho e as dependências.
-
-
Revise e ajuste o plano de teste
O plano de teste gerado fornece informações abrangentes, incluindo:
-
Ordem de execução preferencial com base nas dependências
-
Tarefas de grupos de trabalho a partir do agendador
-
Pontuações de complexidade, que são pontuações agregadas para casos de teste
-
Associações de domínio comercial
-
Métricas de complexidade ciclomática
-
Dependências de conjuntos de dados e tabelas
-
Linhas de métricas de código
-
Mapeamentos de funções de negócios
-
Opções de personalização do plano de teste
Seu plano de teste pode ser personalizado para atender a necessidades específicas. Por exemplo, você pode:
-
Crie novos casos de teste selecionando vários pontos de entrada
-
Mescle casos de teste existentes para combinar funcionalidades relacionadas
-
Divida os casos de teste para testes mais granulares
-
Remova casos de teste desnecessários
-
Adicione ou remova pontos de entrada para casos de teste existentes
-
Modifique as descrições e os atributos dos casos de teste
-
Ajustar a ordem de execução
Informações detalhadas do caso de teste
Cada caso de teste fornece detalhes que descrevem seu conteúdo e o conjunto de dados ou arquivos de dados relacionados:
-
Descrição abrangente do escopo do teste
-
Lista completa de pontos de entrada incluídos
-
Métricas agregadas que mostram complexidade e tamanho
-
Regras de negócios e orientação automatizada de casos de teste
-
Dependências de conjuntos de dados e tabelas com direction () input/output
-
Visualização interativa do gráfico de dependências
-
Pré-requisitos e requisitos de execução
Recursos de gerenciamento de dados
Esses detalhes ajudam você a entender os dados relacionados ao caso de teste. Você pode:
-
Filtrar conjuntos de dados por input/output direção
-
Identifique os artefatos necessários para a execução do teste
-
Acompanhe as dependências de dados entre os casos de teste
-
Monitore o uso do conjunto de dados em todos os planos de teste
nota
AWS O Transform analisa automaticamente as dependências do agendador e atribui pontuações de complexidade para ajudar a priorizar os esforços de teste. Pontuações mais altas de complexidade indicam trabalhos que podem exigir testes ou isolamento mais completos durante o processo de teste.
Regras de negócios e orientação de casos de teste
O plano de teste AWS Transform fornece recomendações para seu plano de caso de teste com base na extração de regras de negócios:
-
Processamento automático de regras de negócios usando LLM
-
Geração de casos de teste sintéticos
-
Orientação de teste para cenários comerciais específicos
-
Rastreabilidade entre regras e casos de teste
O plano de teste final é armazenado no local especificado do S3 e inclui todas as informações necessárias para executar sua estratégia de teste com eficiência. Você pode exportar o plano de teste para integração com outras ferramentas de teste ou sistemas de documentação.
nota
Embora a orientação sintética do caso de teste seja fornecida, os artefatos de teste reais devem ser criados separadamente com base na orientação. O plano de teste serve como um modelo abrangente para sua estratégia de teste, mas não gera os dados de teste nem os scripts de execução.
Regras de criação de casos de teste - Resumo
Regras gerais
-
Um caso de teste contém de 1 a muitos JCLs na ordem de execução do cronograma
-
Os casos de teste são criados a partir de agendadores compatíveis válidos (CA7 e) Control-M
-
O teste executa JCLs, não o agendador em si ou tarefas agendadas
-
Uma tarefa agendada é exclusiva e executa somente um JCL
-
Um JCL pode ser executado por várias tarefas agendadas
-
Um JCL pode existir sem estar em um cronograma
Regras padrão de criação de casos de teste
-
Se um único JCL estiver em um caso de teste:
-
A JCL não está envolvida com um cronograma
-
O JCL é executado por uma tarefa agendada que diverge em várias ramificações
-
Uma ramificação na programação contém somente esse JCL
-
-
Se houver vários JCL em um caso de teste: representa uma sequência de caminho de execução linear em uma ramificação do cronograma
-
Se a JCL estiver em uma tarefa agendada divergente: a JCL se torna seu próprio caso de teste separado
-
Se a JCL estiver em uma tarefa agendada convergente: a JCL pode iniciar um novo caso de teste, mas não será incluída nas ramificações anteriores
-
Os JCLs ausentes são ignorados e a execução continua (com aprimoramento futuro planejado para cortar o caso de teste no ponto JCL ausente)
Regras de operações do usuário
-
Criar caso de teste: o usuário seleciona entre os JCLs disponíveis
-
Terá êxito se existirem JCLs na sequência de ramificações de execução do cronograma
-
Segue a ordem de execução do cronograma
-
-
Adicionar um JCL ao caso de teste: o usuário seleciona entre os JCLs disponíveis
-
É bem-sucedido se o JCL puder existir na execução do cronograma do caso de teste branch/path
-
-
Remover JCL do caso de teste: o usuário pode remover qualquer JCL de um caso de teste
-
Permitido mesmo que cause lacunas no caminho de execução
-
-
Mesclar casos de teste: o usuário seleciona dois casos de teste para combinar
-
É bem-sucedido se os JCLs puderem existir juntos na mesma ramificação de execução do cronograma
-
Mantém a ordem de execução do cronograma
-
-
Caso de teste dividido: o usuário seleciona um JCL em um caso de teste para divisão
-
Cria um novo caso de teste a partir do ponto de divisão
-
Caso de teste original modificado para excluir o ponto de divisão anterior do JCL
-
-
Excluir caso de teste: o usuário pode excluir qualquer caso de teste criado
nota
Você não pode criar, adicionar ou mesclar casos de teste de um agendador branches/path diferente. Um futuro aprimoramento está planejado para permitir operações além das divergent/convergent tarefas no agendador.
Gere scripts de coleta de dados de teste
Você pode gerar scripts JCL para coletar dados de teste de seus sistemas de mainframe com base no plano de teste criado na etapa anterior. AWS O Transform cria automaticamente scripts de coleta de dados para conjuntos de dados, tabelas de banco de dados e arquivos sequenciais necessários para testes abrangentes. O processo de coleta de dados é dividido em quatro fases principais: configuração de entrada, seleção de casos de teste, configuração de scripts e geração de scripts.
Para gerar scripts de coleta de dados de teste
-
Forneça informações sobre o plano de teste
-
No painel de navegação esquerdo, em Coleta de dados de teste, escolha Fornecer entrada do plano de teste.
-
Especifique o caminho do S3 para o arquivo JSON do seu plano de teste em Planejar seus testes de aplicativos modernizados.
-
O campo de entrada é pré-preenchido se o plano de teste tiver sido gerado em uma etapa anterior do trabalho.
-
Você também pode selecionar o plano de teste de outros trabalhos especificando a localização apropriada do S3.
-
-
Selecione casos de teste para coleta de dados
-
Analise a lista completa de casos de teste do seu plano de teste.
-
Filtre e classifique os casos de teste com base em vários atributos:
-
Funções e domínios de negócios
-
Dependências da tabela do banco de dados
-
Requisitos do conjunto de dados
-
Métricas de complexidade
-
Critérios de pesquisa personalizados
-
-
Selecione casos de teste individuais ou use opções de seleção em massa.
-
Analise os detalhes do caso de teste, incluindo pontos de entrada, métricas e regras de negócios, clicando em um caso de teste para ver os detalhes.
-
-
Configurar scripts de coleta de dados
-
Baixe modelos de amostra e arquivos de configuração para referência.
AWS O Transform fornece modelos de amostra para descargas de banco de dados Db2, arquivo VSAM REPRO e processamento sequencial de conjuntos de dados para serem usados como orientação sobre os tipos de modelo esperados pelo processo.
-
Os padrões podem variar de site para site, portanto, a expectativa é que os clientes modifiquem ou substituam esses modelos de acordo com seus próprios padrões.
-
Esses modelos modificados precisam ser carregados em um bucket do S3, onde a coleta de dados de teste possa processá-los.
-
Forneça arquivo de configuração variável (formato JSON) contendo:
-
Prefixos de usuário e constantes específicas do ambiente
-
Parâmetros de configuração do banco de dados
-
Configurações do endpoint de destino e parâmetros de transferência de dados
-
Outros parâmetros necessários definidos pelo usuário e a serem usados em modelos JCL
-
-
Faça upload de modelos de JCL para diferentes métodos de coleta de dados:
-
Modelo Db2: Para descarregar tabelas de banco de dados (personalize para BMC, IBM DSN ou outros utilitários de descarga)
-
Modelo VSAM: para processamento de arquivos VSAM (normalmente usa o utilitário REPRO)
-
Modelo de conjuntos de dados sequenciais: para processar conjuntos de dados sequenciais, conjuntos de dados particionados, GDGs etc.
-
-
-
Revise e gerencie scripts gerados
Os scripts gerados fornecem recursos abrangentes de coleta de dados, incluindo:
-
Scripts separados para coleta de dados “antes” e “depois” da execução do teste
-
Estrutura de script organizada por caso de teste e tipo de dados
-
Os scripts são armazenados automaticamente no bucket do S3 para facilitar o acesso e a transferência
-
Os scripts JCL gerados estão prontos para execução no mainframe
-
A substituição de variáveis é baseada na configuração do usuário definida nos modelos
-
Recursos de geração de scripts
Os scripts gerados são personalizados automaticamente com base em seus modelos e configuração:
-
Template-based geração: usa os modelos JCL fornecidos com substituição de variáveis
-
Ambiente: incorpora sua configuração específica de mainframe
-
Tratamento de tipos de dados: cria scripts apropriados para conjuntos de dados sequenciais, arquivos VSAM e tabelas de banco de dados
-
Coleta para casos de teste: gera scripts de coleta de dados “antes” e “depois”
-
Processamento sequencial do conjunto de dados: a amostra AWS fornecida fornece uma função de transferência de arquivos, mas ela pode ser personalizada para utilitários de compactação disponíveis em seu site ou utilitários como Connect Direct ou transferência gerenciada de arquivos, etc.
Estratégia de coleta de dados
Os scripts gerados oferecem suporte a estratégias abrangentes de coleta de dados:
-
Coleta sequencial de conjuntos de dados: utilitários REPRO e de cópia para VSAM e arquivos simples
-
Descarregamento da tabela do banco de dados: processos de descarregamento do Db2 personalizáveis
-
Processamento sequencial de conjuntos de dados: pós-processamento personalizável de conjuntos de dados sequenciais, como compactação, serviços gerenciados de transferência de arquivos, etc.
-
Gerenciamento de dependências: coleta coordenada com base na definição do caso de teste
nota
AWS O Transform gera scripts com base em seus modelos e configurações. Analise todo o JCL gerado antes de executá-lo em seu ambiente de mainframe para garantir a compatibilidade com a configuração específica do sistema e os requisitos de segurança.
Personalização de modelos e melhores práticas
A coleta de dados de teste ATX fornece recursos flexíveis de personalização de modelos:
-
Multi-utility suporte: Adapte modelos para diferentes utilitários de mainframe (BMC, IBM, DSN)
-
Variable-driven configuração: use constantes para parâmetros específicos do ambiente
-
Modelos reutilizáveis: crie modelos padronizados para geração consistente de scripts
-
Tratamento de dados: incorpore os requisitos de tratamento de dados específicos da organização
-
Integração de segurança: inclua controles adequados de segurança e acesso
-
Otimização de desempenho: configure para coleta e transferência eficientes de dados
Estrutura de saída gerada
Os scripts gerados são organizados em seu bucket do S3 com a seguinte estrutura:
-
Organização do caso de teste: scripts agrupados por casos de teste associados
-
Tempo de coleta: pastas separadas para “antes” e “depois” da coleta de dados
-
Classificação do tipo de dados: scripts organizados por conjuntos de dados sequenciais, tabelas de banco de dados e transferências
-
Arquivos de metadados: informações resumidas e orientação de execução
-
Ready-to-transfer formato: JCL formatado para implantação direta de mainframe
A coleção final de scripts é armazenada no local especificado do S3 e inclui todo o JCL necessário para executar sua estratégia de coleta de dados com eficiência. Você pode baixar os scripts para transferir para seu ambiente de mainframe ou integrá-los aos processos de implantação automatizados.
nota
Embora scripts JCL abrangentes sejam gerados, a execução real deve ser executada em seu ambiente de mainframe. Os scripts servem como ferramentas de coleta de dados prontas para uso, mas exigem permissões apropriadas de acesso e execução ao mainframe.
Geração de scripts de automação de testes
Você pode gerar scripts de automação de teste para executar casos de teste em seu aplicativo modernizado com base no plano de teste criado na etapa anterior. AWS O Transform cria automaticamente scripts de teste abrangentes que utilizam os dados coletados do processo de coleta de dados de teste. O processo de geração de scripts de automação de testes consiste em três fases principais: configuração de entrada, seleção de casos de teste e resultados de geração de scripts.
Para gerar scripts de teste
-
Forneça informações sobre o plano de teste
-
No painel de navegação esquerdo, em Geração de script de automação de teste, escolha Fornecer entrada do plano de teste.
-
Especifique o caminho do S3 para o arquivo JSON do seu plano de teste em Planejar seus testes de aplicativos modernizados.
-
O campo de entrada é pré-preenchido se o plano de teste tiver sido gerado em uma etapa anterior do trabalho.
-
Você também pode selecionar o plano de teste de outros trabalhos especificando a localização apropriada do S3.
-
O sistema usa esse plano de teste como base para gerar scripts de automação.
-
-
Selecione casos de teste para geração de scripts
-
Analise a lista completa de casos de teste do seu plano de teste.
-
Filtre e classifique os casos de teste com base em vários atributos:
-
Funções e domínios de negócios
-
Dependências da tabela do banco de dados
-
Requisitos do conjunto de dados
-
Métricas de complexidade
-
Critérios de pesquisa personalizados
-
-
Selecione casos de teste individuais ou use as opções de seleção em massa com os botões Marcar tudo e Desmarcar tudo.
-
Analise os detalhes do caso de teste, incluindo pontos de entrada, métricas e regras de negócios, clicando nos casos de teste individuais.
Os casos de teste selecionados terão scripts de automação gerados para execução no aplicativo modernizado.
-
-
Revise e gerencie os scripts de automação de testes gerados:
-
O sistema exibe uma mensagem de sucesso confirmando a conclusão da geração do script.
-
Os scripts de teste gerados são armazenados automaticamente no local especificado do bucket do S3.
-
Acesse a lista completa dos scripts de teste gerados com suas respectivas localizações do S3.
-
Cada caso de teste tem seu script de automação correspondente armazenado em locais individuais do S3.
-
Os scripts estão prontos para implantação e execução em seu ambiente de aplicativos modernizado.
-
Recursos do script de automação de testes
Os scripts de automação gerados fornecem recursos de teste abrangentes:
-
Teste de aplicativo modernizado: os scripts são projetados especificamente para executar casos de teste em seu aplicativo transformado
-
Integração de dados: utiliza os dados de teste coletados na etapa anterior de coleta de dados de teste. Esses dados precisam ser copiados para pastas para cada caso de teste
-
Execução automatizada: os scripts podem ser usados para configurar coletores de dados, executar casos de teste e comparar resultados. Alguns parâmetros precisarão ser definidos de acordo com seu ambiente de implantação
-
Estrutura organizada: os scripts são organizados sistematicamente por caso de teste em seu bucket do S3
-
Ready-to-deploy formato: os scripts são formatados para implantação direta em seu ambiente de teste
Estrutura de saída gerada
Os scripts de automação de teste gerados são organizados em seu bucket do S3 com a seguinte estrutura:
-
Organização do caso de teste: cada caso de teste tem seu script dedicado armazenado em uma pasta S3 individual
-
Execution-ready formato: os scripts são formatados para implantação e execução imediatas após a configuração de alguma variável, dependendo do seu ambiente
-
Acesso centralizado: todos os scripts podem ser acessados em um único local de bucket do S3 para facilitar o gerenciamento
Estratégia de execução de testes
Os scripts gerados oferecem suporte a fluxos de trabalho abrangentes de execução de testes:
-
Configuração do ambiente: os scripts incluem recursos para configurar os dados iniciais para executar o teste
-
Preparação de dados: integração com os dados de teste coletados da etapa de coleta de dados do caso de teste
-
Execução de casos de teste: execução automatizada de casos de teste individuais no aplicativo modernizado
-
Comparação de resultados: Built-in recursos para comparar resultados de testes e validar o comportamento do aplicativo
nota
AWS O Transform gera scripts de automação de teste com base no seu plano de teste e nos casos de teste selecionados. Os scripts são projetados para execução em seu ambiente de aplicativos modernizado e utilizam os dados de teste coletados na etapa anterior. Revise todos os scripts gerados antes da implantação para garantir a compatibilidade com os requisitos específicos de configuração e teste do aplicativo.
Melhores práticas para automação de testes
-
Validação do ambiente: garanta que seu ambiente de aplicativos modernizado esteja configurado adequadamente antes da execução do script
-
Verificação de dados: valide se os dados de teste necessários da fase de coleta estão disponíveis e acessíveis
-
Personalização do script: revise e personalize os scripts gerados conforme necessário para seus requisitos específicos de teste
-
Monitoramento de execução: implemente monitoramento e registro apropriados durante a execução do script de teste
-
Análise de resultados: Estabeleça processos para analisar os resultados dos testes e identificar problemas de aplicação
A coleção final de scripts de automação de testes fornece uma estrutura de teste completa para validar a funcionalidade modernizada do seu aplicativo. Os scripts podem ser integrados aos seus processos de teste contínuos ou executados como parte do fluxo de trabalho de validação do aplicativo.
Capacidades de implantação em AWS Transformação
AWS O Transform ajuda você a configurar ambientes de nuvem para aplicativos de mainframe modernizados, fornecendo modelos de infraestrutura como código (IaC) prontos para uso. Por meio da interface de bate-papo do AWS Transform, você pode acessar modelos pré-criados que criam componentes essenciais, como recursos computacionais, bancos de dados, armazenamento e controles de segurança. Os modelos estão disponíveis em formatos populares, incluindo CloudFormation (CFN) e Terraform, oferecendo flexibilidade para implantar sua infraestrutura. AWS Cloud Development Kit (AWS CDK)
Esses modelos servem como elementos básicos que reduzem o tempo e a experiência necessários para configurar ambientes para seus aplicativos de mainframe modernizados. Você pode personalizar esses modelos para atender às suas necessidades, fornecendo uma base para criar seu ambiente de implantação.
Para recuperar os modelos de IaC, peça no bate-papo do AWS Transform os Infrastructure-as-Code modelos que esclarecem seu padrão de modernização preferido (como o AWS Transform for mainframe refactor), sua topologia preferida (independente versus alta disponibilidade) e seu formato preferido (versus Cloud Development CloudFormation Kit versus Terraform).