AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
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á.
# Reformulação de plataformas de aplicativos com a Rocket Software (antiga Micro Focus)
Este guia aborda o end-to-end processo de reformulação de plataformas de aplicativos de mainframe usando soluções de modernização de AWS mainframe em. AWS Ele descreve todas as tarefas e inclui informações sobre como configurar e operar o tempo de execução da modernização de AWS mainframe no Amazon EC2, desde a configuração e análise iniciais até a criação, o teste e a implantação de seus aplicativos modernizados. AWS Também aborda tópicos avançados, como trabalhar com estruturas de dados legadas, usar modelos e projetos predefinidos e configurar a automação para sessões de streaming.
**Topics**
+ [Configurar o Rocket Software (anteriormente Micro Focus) (no Amazon EC2)](mf-runtime-setup.md)
+ [Configure a automação para as sessões de streaming do Rocket Enterprise Analyzer (antigo Micro Focus) e do Rocket Enterprise Developer](set-up-automation-m2.md)
+ [Visualize conjuntos de dados como tabelas e colunas no Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)](view-datasets-tables-m2.md)
+ [Edite conjuntos de dados usando as ferramentas de arquivo de dados da Rocket Software (antiga Micro Focus) no Enterprise Developer](edit-datasets-m2.md)
+ [Tutoriais para Rocket Software (anteriormente Micro Focus)](tutorials-mf.md)
+ [Utilitários em lote disponíveis na modernização do AWS mainframe](utilities-m2.md)
# Configurar o Rocket Software (anteriormente Micro Focus) (no Amazon EC2)
AWS Mainframe Modernization fornece várias Amazon Machine Images (AMIs) que incluem produtos licenciados da Rocket Software (antiga Micro Focus). Essas AMIs permitem que você provisione rapidamente instâncias do Amazon Elastic Compute Cloud (Amazon EC2) para dar suporte aos ambientes da Rocket Software que você controla e gerencia. Este tópico fornece as etapas necessárias para acessá-los e iniciá-los AMIs. Seu uso AMIs é totalmente opcional e não é necessário para concluir os tutoriais deste guia do usuário.
**Topics**
+ [Pré-requisitos para configurar o Rocket Software (antigo Micro Focus) (no Amazon EC2)](mf-runtime-setup-prereq.md)
+ [Criar o endpoint da Amazon VPC para o Amazon S3](mf-runtime-setup-vpc.md)
+ [Solicitar a atualização da lista de permissões para a conta](mf-runtime-setup-allowlist.md)
+ [Crie a AWS Identity and Access Management função](mf-runtime-setup-iam-role.md)
+ [Conceda ao License Manager as permissões necessárias](mf-runtime-setup-lic.md)
+ [Inscreva-se para receber as imagens de máquina da Amazon](mf-runtime-setup-ami.md)
+ [Inicie uma instância da AWS Mainframe Modernization Rocket Software (antiga Micro Focus)](mf-runtime-setup-mf-instance.md)
+ [Sub-rede ou VPC sem acesso à Internet](mf-runtime-setup-no-access.md)
# Pré-requisitos para configurar o Rocket Software (antigo Micro Focus) (no Amazon EC2)
Ao configurar o Rocket Software (no Amazon EC2), certifique-se de atender aos seguintes pré-requisitos.
+ Acesso do administrador à conta na qual as instâncias do Amazon EC2 serão criadas.
+ Identifique Região da AWS onde as instâncias do Amazon EC2 serão criadas e verifique se o AWS Mainframe Modernization serviço está disponível. Consulte [Serviços por região AWS](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Selecione uma região na qual o serviço esteja disponível.
+ Identifique a Amazon Virtual Private Cloud (Amazon VPC) na qual as instâncias do Amazon EC2 serão criadas.
# Criar o endpoint da Amazon VPC para o Amazon S3
Nesta seção, você cria um endpoint da Amazon VPC para o Amazon S3 usar. A configuração desse endpoint ajudará você mais tarde ao configurar o acesso à Internet para VPC.
1. Navegue até a Amazon VPC no Console de gerenciamento da AWS.
1. No painel de navegação, escolha **Endpoints**.
1. Escolha **Criar endpoint**.
![\[Endpoints da VCP com Create Endpoint ativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg)
1. Insira uma etiqueta de nome significativa, por exemplo: “Micro-Focus-License-S3”.
1. Escolha **AWS Services** como a categoria de serviço.
![\[Configurações do endpoint com a etiqueta de nome de amostra inserida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_2.png)
1. Em **Serviços**, pesquise o serviço Amazon S3 Gateway: **com.amazonaws.[region].s3**.
Para `us-west-1`, isso seria: `com.amazonaws.us-west-1.s3`.
1. Escolha o serviço **Gateway**.
![\[Serviços com o serviço Amazon S3 Gateway selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_3.png)
1. Para VPC, escolha a VPC que você usará.
![\[VPC com uma VPC inserida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_4.png)
1. Escolha todas as tabelas de rotas para a VPC.
![\[Tabelas de rotas com todas as tabelas de rotas selecionadas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_5.png)
1. Em **Política**, escolha **Acesso total**.
![\[Política com acesso total selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-s3-endpoint_6.png)
**nota**
Se você decidir criar uma política personalizada, garanta que ela tenha acesso ao bucket `s3://aws-supernova-marketplace--prod` do Amazon S3.
1. Escolha **Criar endpoint**.
# Solicitar a atualização da lista de permissões para a conta
Trabalhe com seu AWS representante para que sua conta seja permitida para o. AWS Mainframe Modernization AMIs Forneça as seguintes informações:
+ O Conta da AWS ID.
+ O Região da AWS local onde o endpoint Amazon VPC foi criado.
+ O ID do endpoint da Amazon VPC Amazon S3 criado em [Criar o endpoint da Amazon VPC para o Amazon S3](mf-runtime-setup-vpc.md). Esse é o id `vpce-xxxxxxxxxxxxxxxxx` do endpoint **com.amazonaws.[region].s3 Gateway**.
+ O número de licenças necessárias em todas as instâncias do Rocket Software Enterprise Suite AMI Amazon EC2.
É necessária uma licença por núcleo de CPU (por 2 vCPUs para a maioria das instâncias do Amazon EC2).
Para obter mais informações, consulte [Otimizar as opções da CPU](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized).
O número solicitado pode ser ajustado futuramente por AWS.
**nota**
Entre em contato com seu AWS representante ou AWS Support ele abrirá o ticket de suporte para a solicitação da Lista de Permissões em seu nome. Ela não pode ser solicitada diretamente por você e a solicitação pode levar vários dias para ser concluída.
# Crie a AWS Identity and Access Management função
Crie uma AWS Identity and Access Management política e uma função para serem usadas pelas instâncias do AWS Mainframe Modernization Amazon EC2. Criar a função por meio do console do IAM criará um perfil da instância associado com o mesmo nome. A atribuição desse perfil de instância às instâncias do Amazon EC2 permite que as licenças da Rocket Software sejam atribuídas. Para obter mais informações sobre perfis de instância, consulte [Uso de um perfil do IAM para conceder permissões a aplicações executadas em instâncias do Amazon EC2](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html).
## Criar uma política do IAM.
Uma política de IAM é criada primeiro e depois anexada à função.
1. Navegue até AWS Identity and Access Management no Console de gerenciamento da AWS.
1. Escolha **Políticas** e depois **Criar política**.
![\[Página de política sem filtros aplicados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-policy_1.png)
1. Selecione a guia **JSON**.
![\[Aba JSON sem conteúdo\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-policy_2.png)
1. Substitua o seguinte JSON pelo local `us-west-1` em Região da AWS que o endpoint do Amazon S3 foi definido e, em seguida, copie e cole o JSON no editor de políticas.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "S3WriteObject",
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*"
]
},
{
"Sid": "OtherRequiredActions",
"Effect": "Allow",
"Action": [
"sts:GetCallerIdentity",
"ec2:DescribeInstances",
"license-manager:ListReceivedLicenses"
],
"Resource": [
"*"
]
}
]
}
```
------
**nota**
As ações do Sid `OtherRequiredActions` não oferecem suporte a permissões de nível de recurso e precisam ser especificadas `*` no elemento de recurso.
![\[Aba JSON com a política inserida e us-west-1 destacado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-policy_3.png)
1. Escolha **Próximo: tags**.
![\[Tags sem dados inseridos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-policy_4.png)
1. Opcionalmente, insira qualquer tag e escolha **Próximo: Revisar**.
1. Insira um nome para a política, por exemplo, “Política de licenciamento da Micro-Focus”. Opcionalmente, insira uma descrição, por exemplo, “Uma função que inclua essa política deve ser anexada a cada instância do AWS Mainframe Modernization Amazon EC2".
![\[Revise a política com o nome e a descrição inseridos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-policy_5.png)
1. Escolha **Create Policy**.
## Crie o perfil do IAM.
Depois de criar uma política do IAM, é necessário criar um perfil do IAM e anexar a política a ele.
1. Navegue até IAM no Console de gerenciamento da AWS.
1. Escolha **Perfis** > **Criar perfil**.
![\[Funções sem filtro aplicado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-role_1.png)
1. Deixe o **tipo de entidade confiável** como **serviço AWS ** e escolha o caso de uso comum do **EC2**.
![\[Selecione entidade confiável com AWS serviço e EC2 selecionados\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-role_2.png)
1. Escolha **Próximo**.
1. Digite “Micro” no filtro e pressione enter para aplicar o filtro.
1. Escolha a política que acabou de ser criada, por exemplo, a “Política de licenciamento da Micro-Focus”.
1. Escolha **Próximo**.
![\[Adicione permissões com a política da Micro Focus selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-role_3.png)
1. Insira o nome da função, por exemplo, “Micro-Focus-Licensing-Role”.
1. Substitua a descrição por uma de sua preferência, por exemplo, “Permite que instâncias do Amazon EC2 com essa função obtenham licenças da Micro Focus”.
![\[Detalhes da função com nome e descrição inseridos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-role_4.png)
1. Em **Etapa 1: selecionar entidades confiáveis**, revise o JSON e confirme se ele tem os seguintes valores:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sts:AssumeRole"
],
"Principal": {
"Service": [
"ec2.amazonaws.com"
]
}
}
]
}
```
------
**nota**
A ordem do Efeito, da Ação e do Principal não é significativa.
1. Confirme se a **Etapa 2: adicionar permissões** mostra sua política de licenciamento.
![\[Etapa 2: adicionar permissões com a política de licenciamento selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-create-iam-role_6.png)
1. Selecione **Criar perfil**.
Depois que a solicitação da lista de permissões for concluída, continue com as etapas a seguir.
# Conceda ao License Manager as permissões necessárias
Você precisa conceder permissões AWS License Manager para configurar o mecanismo de tempo de execução da Rocket Software (no Amazon EC2).
1. Navegue até AWS License Manager no Console de gerenciamento da AWS.
![\[AWS License Manager página inicial.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-license-manager_1.png)
1. Escolha **Começar a usar o AWS License Manager**.
1. Se você ver o pop-up a seguir, veja os detalhes, escolha a caixa de seleção e pressione **Conceder Permissões**.
![\[Configuração única de permissões do IAM\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-license-manager_2.png)
# Inscreva-se para receber as imagens de máquina da Amazon
Depois de assinar um AWS Marketplace produto, você pode iniciar uma instância a partir da AMI do produto. Você também pode gerenciar suas AMIs assinadas ao configurar o mecanismo de tempo de execução da Rocket Software (anteriormente Micro Focus) (no Amazon EC2).
1. Navegue até AWS Marketplace Assinaturas no. Console de gerenciamento da AWS
1. Escolha **Manage subscriptions** (Gerenciar assinaturas).
![\[AWS Marketplace página inicial.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_1.png)
1. Copie e cole um dos links a seguir na barra de endereço do navegador.
**nota**
Escolha apenas um link para um dos produtos que você foi autorizado a usar.
Certifique-se de que sua conta esteja na lista de permissões seguindo a [Solicitar a atualização da lista de permissões para a conta](mf-runtime-setup-allowlist.md) página para usar esses links.
+ Servidor corporativo: [https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc)
+ Servidor corporativo para Windows: [https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2)
+ Desenvolvedor corporativo: [https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk)
+ Desenvolvedor corporativo com Visual Studio 2022: [https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm)
+ [Analisador empresarial: https://aws.amazon.com/marketplace/ pp/prodview-tttheylcmcihm](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm)
+ Ferramentas de compilação empresarial para Windows: [https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi)
+ Procedimentos armazenados da empresa: [https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha)
+ Procedimentos armazenados corporativos com o SQL Server 2019: [https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4)
1. Escolha **Continuar para assinar**.
![\[Oferta de servidor corporativo em AWS Marketplace.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_2.png)
1. Se os Termos e Condições forem aceitáveis, escolha **Aceitar Termos**.
![\[Termos e condições da assinatura.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_3.png)
1. A assinatura pode levar alguns minutos para ser processada.
![\[Mensagem de assinatura pendente.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_4.png)
1. Depois que a mensagem de agradecimento for exibida, copie e cole o próximo link da etapa 3 para continuar adicionando assinaturas.
![\[Mensagem de agradecimento da assinatura.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_5.png)
1. Pare quando **Gerenciar assinaturas** mostrar todos os seus inscritos. AMIs
**nota**
As preferências do painel (ícone de engrenagem) estão configuradas para mostrar a exibição como uma tabela.
![\[Gerencie assinaturas com lista de inscritos. AMIs\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-ami-subscription_6.png)
# Inicie uma instância da AWS Mainframe Modernization Rocket Software (antiga Micro Focus)
Depois de criar endpoints, política do IAM, função do IAM e se inscrever AMIs, você está pronto para iniciar uma instância da AWS Mainframe Modernization Rocket Software (Micro Focus) no. Console de gerenciamento da AWS
1. Navegue até AWS Marketplace Assinaturas no. Console de gerenciamento da AWS
1. Localize a AMI a ser executada e escolha **Iniciar nova instância**.
![\[Gerencie assinaturas com o Enterprise Server e o Enterprise Analyzer prontos para serem lançados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_1.png)
1. Na caixa de diálogo Iniciar nova instância, verifique se a região da lista de permissões está selecionada.
1. Pressione **Continuar para iniciar por meio do EC2**.
**nota**
O exemplo a seguir mostra o lançamento de uma AMI para desenvolvedores corporativos, mas o processo é o mesmo para todos os AWS Mainframe Modernization AMIs.
![\[Executa uma nova instância.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_2.png)
1. Digite um nome para o servidor.
1. Escolha um tipo de instância.
O tipo de instância selecionado deve ser determinado pelo desempenho do projeto e pelos requisitos de custo. A seguir estão os pontos de partida sugeridos:
+ Para o Enterprise Analyzer, um r6i.xlarge
+ Para desenvolvedores corporativos, um r6i.large
+ Para uma instância autônoma do Enterprise Server, um r6i.xlarge
+ Para Rocket Software Performance Availability Cluster (PAC) com escalabilidade horizontal, um r6i.large
**nota**
A seção Imagens da aplicação e do sistema operacional foi reduzida para a captura de tela.
![\[Execute uma instância com o nome e o tipo de instância inseridos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_3.png)
1. Escolha ou crie (e salve) um par de chaves (não exibido).
Para obter mais informações sobre pares de chaves para instâncias do Linux, consulte [Pares de chaves do Amazon EC2 e instâncias do Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html).
Para obter mais informações sobre pares de chaves para instâncias do Windows, consulte [Pares de chaves do Amazon EC2 e instâncias do Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html).
1. Edite as configurações de rede e **escolha a VPC permitida** e a sub-rede apropriada.
1. Escolha **Criar um novo grupo de segurança**. Se for uma instância do Enterprise Server EC2, é normal permitir o tráfego TCP para as portas 86 e 10086 para administrar a configuração do Rocket Software.
1. Opcionalmente, configure o armazenamento para a instância do Amazon EC2.
1. Importante: expanda os detalhes avançados e, em Perfil da instância do IAM, escolha a função de licenciamento criada anteriormente, por exemplo, “Micro-Focus-Licensing-Role”.
**nota**
Se essa etapa for perdida, depois que a instância for criada, você poderá modificar o perfil do IAM na opção Segurança do menu Ação da instância EC2.
![\[Detalhes avançados com o perfil de instância do IAM inserido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_4.png)
1. Revise o resumo e envie a **Iniciar instância**.
![\[Resumo com as opções selecionadas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_5.png)
1. A inicialização da instância falhará se um tipo de servidor virtual inválido for escolhido.
Se isso acontecer, escolha **Editar configuração da instância** e altere o tipo de instância.
![\[Mensagem de progresso da instância de lançamento.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_6.png)
1. Depois que a mensagem “Sucesso” for exibida, escolha **Conectar-se à instância** para obter os detalhes da conexão.
![\[Mensagem de sucesso do lançamento da instância.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_7.png)
1. Como alternativa, navegue até **EC2** no Console de gerenciamento da AWS.
1. Escolha **Instâncias** para ver o status da nova instância.
![\[Lista de instâncias com status.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-launch-instance_8.png)
# Sub-rede ou VPC sem acesso à Internet
Faça essas alterações adicionais se a sub-rede ou a VPC não tiver acesso de saída à Internet.
O gerenciador de licenças exige acesso aos seguintes serviços da AWS:
+ com.amazonaws. *region*.s3
+ com.amazonaws. *region*.ec2
+ com.amazonaws. *region*.gerenciador de licenças
+ com.amazonaws. *region*.sts
As etapas anteriores definiram o com.amazonaws. *region*serviço.s3 como um endpoint de gateway. Esse endpoint precisa de uma entrada na tabela de rotas para qualquer sub-rede sem acesso à Internet.
Os três serviços adicionais serão definidos como endpoints de interface.
**Topics**
+ [Adicione a entrada da tabela de rotas para o endpoint do Amazon S3](#mf-runtime-setup-no-access-route-table)
+ [Defina o grupo de segurança necessário](#mf-runtime-setup-no-access-security-group)
+ [Criar os endpoints de serviço](#mf-runtime-setup-no-access-endpoints)
## Adicione a entrada da tabela de rotas para o endpoint do Amazon S3
1. **Navegue até **VPC** em Console de gerenciamento da AWS e escolha Sub-redes.**
1. Selecione a sub-rede na qual as instâncias do Amazon EC2 serão criadas e selecione a guia Tabela de rotas.
1. Observe alguns dígitos finais do ID da tabela de rotas. Por exemplo, o 6b39 na imagem abaixo.
![\[Detalhes da tabela de rotas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_1.png)
1. No painel de navegação, escolha **Endpoints**.
1. Escolha o endpoint criado anteriormente e, em seguida, **Gerenciar tabelas de rotas**, na guia Tabelas de rotas do endpoint ou no menu suspenso Ações.
1. Escolha a tabela de rotas usando os dígitos identificados anteriormente e pressione Modificar tabelas de rotas.
![\[Tabela de rotas selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_2.png)
## Defina o grupo de segurança necessário
Os serviços Amazon EC2 e License Manager se comunicam via HTTPS pela porta 443. AWS STS Essa comunicação é bidirecional e requer regras de entrada e saída para permitir que a instância se comunique com os serviços.
1. Navegue até a Amazon VPC no Console de gerenciamento da AWS.
1. Localize **Grupos de segurança** na barra de navegação e selecione **Criar grupo de segurança**.
1. Insira o nome e a descrição do grupo de segurança, por exemplo, “HTTPS de entrada e saída”.
1. Pressione o X na área de seleção da VPC para **remover a VPC padrão e escolha a VPC** que contém o endpoint do S3.
1. Adicione uma regra de entrada que **permita o tráfego TCP na porta 443** de qualquer lugar.
**nota**
As regras de entrada (e saída) podem ser restringidas ainda mais limitando a Fonte. Para obter mais informações, consulte [Controle o tráfego para seus AWS recursos usando grupos de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) no Guia do *usuário da Amazon VPC*.
![\[Detalhes básicos com a regra de entrada inserida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_3.png)
1. Pressione **Criar grupo de segurança**.
## Criar os endpoints de serviço
Repita esse processo três vezes — uma vez para cada serviço.
1. **Navegue até Amazon VPC em Console de gerenciamento da AWS e escolha Endpoints.**
1. Pressione **Criar endpoint**.
1. Insira um nome, por exemplo, “Micro-Focus-License-EC2”, “Micro-Focus-License-STS” ou “Micro-Focus-License-Manager”.
1. Escolha a categoria de serviço **AWS Services**.
![\[Configurações do endpoint com os AWS serviços selecionados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_4.png)
1. Em Serviços, procure o serviço de interface correspondente, que é um dos seguintes:
+ “com.amazonaws. *region*.ec2”
+ “com.amazonaws. *region*.sts”
+ “com.amazonaws. *region*.gerenciador de licenças”
Por exemplo:
+ “com.amazonaws.us-west-1.ec2”
+ “com.amazonaws.us-west-1.sts”
+ “com.amazonaws.us-west-1.license-manager”
1. Escolha o serviço de interface correspondente.
**com.amazonaws. *region*.ec2**:
![\[Serviços com o serviço de interface Amazon EC2 selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_5.png)
**com.amazonaws. *region*.sts**:
![\[Serviços com serviço de AWS STS interface selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_6.png)
**com.amazonaws. *region*.gerenciador de licenças**:
![\[Serviços com o serviço de interface do License Manager selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_7.png)
1. Para VPC, escolha a VPC para a instância.
![\[VPC com a VPC da instância selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_8.png)
1. Escolha a **Zona de disponibilidade** e as **Sub-redes** para a VPC.
![\[Sub-redes com zona de disponibilidade e sub-rede para a VPC selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_9.png)
1. Escolha Criar para criar o grupo de segurança.
![\[Grupos de segurança com o grupo de segurança selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_10.png)
1. Em Política, escolha **Acesso total**.
![\[Política com acesso total selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-no-internet_11.png)
1. Escolha **Criar endpoint**.
1. Repita este processo para as interfaces restantes.
# Configure a automação para as sessões de streaming do Rocket Enterprise Analyzer (antigo Micro Focus) e do Rocket Enterprise Developer
Você pode executar automaticamente um script no início e no final da sessão para permitir uma automação específica para o contexto do seu cliente. Para obter mais informações sobre esse recurso de WorkSpaces aplicativos, consulte [Use scripts de sessão para gerenciar a experiência de streaming de seus usuários AppStream 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html) no *Guia de administração de WorkSpaces aplicativos da Amazon*.
Esse recurso exige que você tenha pelo menos as seguintes versões das imagens do Enterprise Analyzer e do Enterprise Developer:
+ `m2-enterprise-analyzer-v8.0.4.R1`
+ `m2-enterprise-developer-v8.0.4.R1`
**Topics**
+ [Configure a automação no início da sessão](#set-up-automation-m2.start)
+ [Configure a automação no final da sessão](#set-up-automation-m2.end)
## Configure a automação no início da sessão
Se você quiser executar um script de automação quando os usuários se conectarem aos WorkSpaces aplicativos, crie seu script e dê um nome a ele`m2-user-setup.cmd`. Armazene o script na pasta inicial dos WorkSpaces aplicativos para o usuário. As imagens de WorkSpaces aplicativos que o AWS Mainframe Modernization fornece procuram um script com esse nome nesse local e o executam, se ele existir.
**nota**
A duração do script não pode exceder o limite definido pelos WorkSpaces Aplicativos, que atualmente é de 60 segundos. Para obter mais informações, consulte [Executar scripts antes do início das sessões de streaming](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin) no *Guia de administração de WorkSpaces aplicativos da Amazon*.
## Configure a automação no final da sessão
Se você quiser executar um script de automação quando os usuários se desconectarem dos WorkSpaces Aplicativos, crie seu script e dê um nome a ele`m2-user-teardown.cmd`. Armazene o script na pasta inicial dos WorkSpaces aplicativos para o usuário. As imagens de WorkSpaces aplicativos que o AWS Mainframe Modernization fornece procuram um script com esse nome nesse local e o executam, se ele existir.
**nota**
A duração do script não pode exceder o limite definido pelos WorkSpaces Aplicativos, que atualmente é de 60 segundos. Para obter mais informações, consulte [Executar scripts após o término das sessões de streaming](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end) no *Guia de administração de WorkSpaces aplicativos da Amazon*.
# Visualize conjuntos de dados como tabelas e colunas no Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)
Você pode acessar conjuntos de dados de mainframe que são implantados na Modernização de AWS Mainframe usando o tempo de execução do Rocket Software (anteriormente Micro Focus). Você pode visualizar os conjuntos de dados migrados como tabelas e colunas de uma instância do Rocket Enterprise Developer. A visualização de conjuntos de dados dessa forma possibilita que você:
+ Execute operações `SQL SELECT` nos arquivos de dados migrados.
+ Exponha dados fora da aplicação de mainframe migrado sem alterar a aplicação.
+ Filtre dados com facilidade e salve como CSV ou outros formatos de arquivo.
**nota**
As etapas 1 e 2 são atividades únicas. Repita as etapas 3 e 4 para cada conjunto de dados para criar as visualizações de banco de dados.
**Topics**
+ [Pré-requisitos](#view-datasets-tables-m2.prereq)
+ [Etapa 1: Configurar a conexão ODBC com o armazenamento de dados da Rocket Software (banco de dados Amazon RDS)](#view-datasets-tables-m2.odbc)
+ [Etapa 2: criar o arquivo MFDBFH.cfg](#view-datasets-tables-m2.config)
+ [Etapa 3: criar um arquivo de estrutura (STR) para o layout do seu caderno](#view-datasets-tables-m2.str)
+ [Etapa 4: criar a visualização de banco de dados usando o arquivo de estrutura (STR)](#view-datasets-tables-m2.dbview)
+ [Etapa 5: Visualize os conjuntos de dados da Rocket Software (antiga Micro Focus) como tabelas e colunas](#view-datasets-tables-m2.cols)
## Pré-requisitos
+ Você deve ter acesso ao Rocket Enterprise Developer Desktop por meio de WorkSpaces aplicativos.
+ Você deve ter um aplicativo implantado e executado sob a modernização do AWS mainframe usando o mecanismo de tempo de execução da Rocket Software.
+ Você está armazenando dados de aplicações na edição compatível com o Aurora PostgreSQL.
## Etapa 1: Configurar a conexão ODBC com o armazenamento de dados da Rocket Software (banco de dados Amazon RDS)
Nesta etapa, você configura uma conexão ODBC com o banco de dados que contém os dados que você deseja visualizar como tabelas e colunas. Esta é uma etapa única.
1. Faça login no Rocket Enterprise Developer Desktop usando o URL de streaming de WorkSpaces aplicativos.
1. Abra o **ODBC Data Source Administrator**, escolha **DSN do usuário** e, em seguida, escolha **Adicionar**.
1. Em **Criar nova fonte de dados**, escolha **PostgreSQL** ANSI e, em seguida, escolha **Concluir**.
1. Crie uma fonte de dados `PG.POSTGRES` fornecendo as informações necessárias do banco de dados, da seguinte forma:
```
Data Source : PG.POSTGRES
Database : postgres
Server : rds_endpoint.rds.amazonaws.com
Port : 5432
User Name : user_name
Password : user_password
```
![\[Configurando a conexão ODBC do Postgres no Enterprise Developer.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-odbc.png)
1. Escolha **Testar** para garantir que a conexão funcione. Você deverá ver a mensagem `Connection successful` se o teste for bem-sucedido.
Se o teste não for bem-sucedido, analise as informações a seguir.
+ [Solução de problemas para o Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html)
+ [Como resolvo problemas ao me conectar à minha instância de banco de dados Amazon RDS?](https://repost.aws/knowledge-center/rds-cannot-connect)
1. Salve a fonte de dados.
1. Crie uma fonte de dados para `PG.VSAM`, teste a conexão e salve a fonte de dados. Forneça as seguintes informações para seu banco de dados:
```
Data Source : PG.VSAM
Database : MicroFocus$SEE$Files$VSAM
Server : rds_endpoint.rds.amazonaws.com
Port : 5432
User Name : user_name
Password : user_password
```
![\[Configuração da fonte de dados PG.VSAM ODBC no Enterprise Developer.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-pg-vsam.png)
## Etapa 2: criar o arquivo MFDBFH.cfg
Nesta etapa, crie um arquivo de configuração que descreve o armazenamento de dados da Micro Focus. Esta é uma etapa única de configuração.
1. Na sua pasta pessoal, por exemplo, em `D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg`, crie o arquivo MFDBFH.cfg com o conteúdo a seguir.
```
```
1. Verifique a configuração do MFDBFH executando os seguintes comandos para consultar o datastore da Micro Focus:
```
*##*
*## Test the connection by running the following commands*
*##*
set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg"
dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA
```
## Etapa 3: criar um arquivo de estrutura (STR) para o layout do seu caderno
Nesta etapa, você cria um arquivo de estrutura para o layout do seu caderno para poder usá-lo posteriormente para criar visualizações de banco de dados a partir dos conjuntos de dados.
1. Compile o programa associado ao seu caderno. Se nenhum programa estiver usando o caderno, crie e compile um programa simples como o seguinte com uma instrução COPY para seu caderno.
```
IDENTIFICATION DIVISION.
PROGRAM-ID. TESTPGM1.
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
DATA DIVISION.
WORKING-STORAGE SECTION.
COPY CVTRA05Y.
PROCEDURE DIVISION.
GOBACK.
```
1. Após a compilação bem-sucedida, clique com o botão direito do mouse no programa e escolha **Criar arquivo de layout de registro**. Isso abrirá as Ferramentas de Arquivo de Dados da Micro Focus usando o arquivo.idy gerado durante a compilação.
![\[Localização do comando Criar arquivo de layout de registro no Enterprise Developer.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-idy-file.png)
1. Clique com o botão direito na estrutura de registro e escolha **Criar layout padrão** (estrutura única) ou **Criar layout condicional** (estrutura múltipla), dependendo do layout.
Para obter mais informações, consulte [Criação de arquivos e layouts de estrutura](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html) na documentação da Micro Focus.
![\[Localização dos comandos de layout nas ferramentas de arquivo de dados da Micro Focus.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png)
1. Depois de criar o layout, escolha **Arquivo** no menu e escolha **Salvar como**. Navegue e salve o arquivo em sua pasta pessoal com o mesmo nome de arquivo do seu caderno. Você pode escolher criar uma pasta chamada `str` e salvar todos os seus arquivos de estrutura lá.
![\[Salvando o arquivo str no Enterprise Developer.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-save-str.png)
## Etapa 4: criar a visualização de banco de dados usando o arquivo de estrutura (STR)
Nesta etapa, você usa o arquivo de estrutura criado anteriormente para criar uma visualização do banco de dados para um conjunto de dados.
+ Use o comando `dbfhview` para criar uma visualização do banco de dados para um conjunto de dados que já está no datastore da Micro Focus, conforme mostrado no exemplo a seguir.
```
##
## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS
## using the STR file CVTRA05Y.str
##
dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA
##
## Output:
##
Micro Focus Database File Handler - View Generation Tool Version 8.0.00
Copyright (C) 1984-2022 Micro Focus. All rights reserved.
VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT'
VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM'
VGN0002I The operation completed successfully
```
## Etapa 5: Visualize os conjuntos de dados da Rocket Software (antiga Micro Focus) como tabelas e colunas
Nesta etapa, conecte-se ao banco de dados usando `pgAdmin` para que você possa executar consultas para visualizar os conjuntos de dados, como tabelas e colunas.
+ Conecte-se ao banco de dados `MicroFocus$SEE$Files$VSAM` usando o pgAdmin e consulte a visualização do banco de dados que você criou na etapa 4.
```
SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT";
```
![\[Conjunto de dados migrados mostrando tabelas e colunas no pgAdmin.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png)
# Edite conjuntos de dados usando as ferramentas de arquivo de dados da Rocket Software (antiga Micro Focus) no Enterprise Developer
Você pode visualizar e editar conjuntos de dados na Modernização do AWS Mainframe usando o tempo de execução do Rocket Software para qualquer conjunto de dados migrado.
As etapas deste documento guiarão você pelo processo de acesso aos conjuntos de dados usando as Ferramentas de Arquivo de Dados.
Isso permite que você visualize e edite os conjuntos de dados migrados conforme necessário.
**Topics**
+ [Pré-requisitos](#edit-datasets-m2.prereq)
+ [Ferramentas de arquivo de dados Launch Rocket Software (anteriormente Micro Focus)](#edit-datasets-m2-launch)
+ [Edite conjuntos de dados VSAM armazenados no banco de dados MFDBFH](#edit-datasets-m2-vsam)
+ [Edite conjuntos de dados não VSAM armazenados no banco de dados MFDBFH](#edit-datasets-m2-nonvsam)
+ [Edite conjuntos de dados VSAM e não VSAM armazenados no sistema de arquivos (EFS/FSx)](#edit-datasets-m2-open)
## Pré-requisitos
Antes de começar, você deve ter um aplicativo implantado com os conjuntos de dados importado pelo serviço de modernização de AWS mainframe usando o mecanismo Rocket Software.
Para continuar editando os conjuntos de dados, você deve concluir a Etapa 1, Etapa 2, e (opcionalmente) Etapa 3 da [Visualize conjuntos de dados como tabelas e colunas no Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)](view-datasets-tables-m2.md) página para configurar a conexão ODBC e o armazenamento de dados Micro Focus (ou seja,). `MFDBFH`
**Importante**
Este guia pressupõe que você esteja usando o Amazon Aurora Postgres como armazenamento de dados da Micro Focus () `MFDBFH` para armazenar os dados do seu aplicativo.
## Ferramentas de arquivo de dados Launch Rocket Software (anteriormente Micro Focus)
Depois de concluir os pré-requisitos, você inicia as Micro Focus Data File Tools configurando a variável de `MFDBFH_CONFIG` ambiente para acessar os conjuntos de dados armazenados no banco de dados (). `MFDBFH`
Para fazer isso,
1. Faça login na área de trabalho do Micro Focus Enterprise Developer e inicie o **prompt de comando do Enterprise Developer (64 bits)** **no menu Iniciar**.
1. Defina a variável de `MFDBFH_CONFIG` ambiente com o caminho completo para seu `MFDBCH.cfg` arquivo.
```
set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg"
```
1. Inicie o Micro Focus Data File Tools na linha de comando do Enterprise Developer usando o comando a seguir.
```
mfdatatools2
```
![\[Prompt de comando para desenvolvedores corporativos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-launch.png)
Isso abre as ferramentas de arquivo de dados da Micro Focus em uma janela separada.
## Edite conjuntos de dados VSAM armazenados no banco de dados MFDBFH
Depois de iniciar as Micro Focus Data File Tools, você abre um conjunto de dados VSAM que está armazenado no armazenamento de dados da Micro Focus.
Para fazer isso,
1. **No menu Arquivo** na janela Micro Focus Data File Tools, escolha **Data Explorer**.
1. Na seção Data Explorer, escolha **Configurações** (ícone de engrenagem) para configurar uma nova conexão. Isso abre uma janela de **configurações da fonte de dados**.
![\[Janela Micro Focus Data File Tools com seção Data Explorer.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-data-source.png)
1. Na janela Configurações da fonte de dados, escolha a guia **MFDBFH** e insira os seguintes valores:
+ Servidor: `ESPACDatabase`
+ Armazenamento de dados: `VSAM`
Escolha **Aplicar** para salvar a configuração.
![\[Janela Micro Focus Data File Tools Configurações da fonte de dados com a guia MFDBFH.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png)
O Data Explorer agora mostra todos os conjuntos de dados armazenados em`MFDBFH`.
![\[Janela Micro Focus Data File Tools com a seção Data Explorer exibindo todos os conjuntos de dados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-datasets.png)
1. Expanda o caminho relativo `DATA` e clique duas vezes no conjunto de dados VSAM que você deseja abrir.
1. Na janela **Abrir arquivo de dados**, escolha **Abrir compartilhado** ou **Abrir exclusivo** para abrir o conjunto de dados.
![\[Janela Micro Focus Data File Tools com a seção Data Explorer Abra a seção Arquivo de Dados para abrir conjuntos de dados..\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-data-set.png)
Agora você pode visualizar ou editar o conjunto de dados aberto.
## Edite conjuntos de dados não VSAM armazenados no banco de dados MFDBFH
Se você quiser editar conjuntos de dados não VSAM, abra um conjunto de dados não VSAM que está armazenado no armazenamento de dados da Micro Focus.
Para fazer isso,
1. No prompt de comando do Enterprise Developer (64 bits), execute o `dbfhdeploy data extract` comando para baixar o conjunto de dados não VSAM para o sistema de arquivos local.
**nota**
Antes de executar esse comando, certifique-se de ter definido a variável de `MFDBFH_CONFIG` ambiente com o caminho completo para seu `MFDBFH.cfg` arquivo.
```
dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT
```
1. Inicie o Micro Focus Data File Tools no **menu Iniciar**.
1. No menu Arquivo das Ferramentas de Arquivo de Dados da Micro Focus, escolha **Abrir** e, em seguida, escolha **Arquivo de Dados**.
1. Na janela Abrir arquivo de dados, navegue pelo conjunto de dados baixado em seu sistema de arquivos local. Edite os **detalhes do arquivo** conforme necessário. Em seguida, escolha **Abrir compartilhado** ou **Abrir exclusivo** para abrir o conjunto de dados.
![\[Abra a janela Arquivos de dados com a guia local selecionada para navegar pelos conjuntos de dados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/edit-mfdbfh-browse.png)
Agora você pode visualizar ou editar o conjunto de dados aberto.
Os conjuntos de dados editados ou atualizados podem ser importados de volta para o armazenamento de dados da Micro Focus usando etapas em [Importar conjuntos de dados para AWS Mainframe Modernization aplicativos](applications-m2-dataset.md) ou usando [o utilitário de linha de comando dbfhdeploy](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html).
## Edite conjuntos de dados VSAM e não VSAM armazenados no sistema de arquivos (EFS/FSx)
Você também pode abrir um conjunto de dados armazenado em um sistema de arquivos.
Para fazer isso,
1. Monte o sistema de EFS/FSx arquivos na instância EC2 do Enterprise Developer.
1. Use as ferramentas de arquivo de dados da Micro Focus para navegar e abrir os conjuntos de dados do sistema de arquivos.
# Tutoriais para Rocket Software (anteriormente Micro Focus)
Os tutoriais desta seção ajudam você a começar a configurar várias tarefas no mecanismo de tempo de execução da Rocket Software para o serviço de modernização de AWS mainframe. Esses tutoriais são para configurar o aplicativo de amostra, usar modelos com o Rocket Enterprise Developer e configurar o Enterprise Analyzer.
**Topics**
+ [Tutorial: Configurando a versão do Rocket Software (anteriormente Micro Focus) para o BankDemo aplicativo de amostra](tutorial-build-mf.md)
+ [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md)
+ [Tutorial: Use modelos com o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)](tutorial-templates-ed.md)
+ [Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces](set-up-ea.md)
+ [Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces](set-up-ed.md)
# Tutorial: Configurando a versão do Rocket Software (anteriormente Micro Focus) para o BankDemo aplicativo de amostra
AWS A modernização do mainframe oferece a capacidade de configurar pipelines de compilação e integration/continuous entrega contínua (CI/CD) para seus aplicativos migrados. Essas compilações e pipelines usam AWS CodeBuild AWS CodeCommit, e AWS CodePipeline para fornecer esses recursos. CodeBuild é um serviço de compilação totalmente gerenciado que compila seu código-fonte, executa testes de unidade e produz artefatos prontos para implantação. CodeCommit é um serviço de controle de versão que permite armazenar e gerenciar de forma privada repositórios Git na nuvem. AWS CodePipeline é um serviço de entrega contínua que permite modelar, visualizar e automatizar as etapas necessárias para lançar seu software.
Este tutorial demonstra como usá-lo para AWS CodeBuild compilar o código-fonte do aplicativo de BankDemo amostra do Amazon S3 e depois exportar o código compilado de volta para o Amazon S3.
AWS CodeBuild é um serviço de integração contínua totalmente gerenciado que compila o código-fonte, executa testes e produz pacotes de software prontos para implantação. Com CodeBuild, você pode usar ambientes de compilação predefinidos ou criar ambientes de compilação personalizados que usam suas próprias ferramentas de compilação. Esse cenário de demonstração usa a segunda opção. Ele consiste em um ambiente de CodeBuild construção que usa uma imagem Docker pré-empacotada.
**Importante**
Antes de iniciar seu projeto de modernização de mainframe, recomendamos que você conheça o [Programa de Aceleração da Migração (MAP) da AWS para mainframe](https://aws.amazon.com/migration-acceleration-program/mainframe/) ou entre em contato com os [especialistas em mainframe](mailto: mainframe@amazon.com) da AWS para saber mais sobre as etapas necessárias para modernizar uma aplicação de mainframe.
**Topics**
+ [Pré-requisitos](#tutorial-build-mf-prerequisites)
+ [Etapa 1: compartilhar os ativos de construção com a AWS conta](#tutorial-build-mf-assets)
+ [Etapa 2: criar buckets do Amazon S3](#tutorial-build-mf-s3)
+ [Etapa 3: criar o arquivo de especificações de compilação](#tutorial-build-mf-spec)
+ [Etapa 4: fazer upload dos arquivos de origem](#tutorial-build-mf-upload)
+ [Etapa 5: criar políticas do IAM](#tutorial-build-mf-IAM-policy)
+ [Etapa 6: criar um perfil do IAM](#tutorial-build-mf-IAM-role)
+ [Etapa 7: anexar as políticas do IAM ao perfil do IAM](#tutorial-build-mf-attach)
+ [Etapa 8: criar o CodeBuild projeto](#tutorial-build-mf-create-project)
+ [Etapa 9: iniciar a compilação](#tutorial-build-mf-start)
+ [Etapa 10: baixar artefatos de saída](#tutorial-build-mf-download-output)
+ [Limpar os recursos](#tutorial-build-mf-clean)
## Pré-requisitos
Antes de iniciar este tutorial, conclua os seguintes pré-requisitos.
+ Baixe o [aplicativo BankDemo de amostra](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) e descompacte-o em uma pasta. A pasta de origem contém programas e cadernos COBOL, além de definições. Ele também contém uma pasta JCL para referência, embora você não precise criar o JCL. A pasta também contém os meta-arquivos necessários para a compilação.
+ **No console de modernização do AWS mainframe, escolha Ferramentas.** Em **Análise, desenvolvimento e criação de ativos**, selecione **Compartilhar ativos com minha conta da AWS**.
## Etapa 1: compartilhar os ativos de construção com a AWS conta
Nesta etapa, você garante compartilhar os ativos de construção com sua AWS conta, especialmente na região em que os ativos estão sendo usados.
1. Abra o console de modernização do AWS mainframe em. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)
1. Na navegação à esquerda, selecione **Ferramentas**.
1. Em **Análise, desenvolvimento e criação de ativos**, escolha **Compartilhar ativos com minha AWS conta**.
**Importante**
Você precisa executar essa etapa uma vez em cada AWS região em que pretende fazer construções.
## Etapa 2: criar buckets do Amazon S3
Nesta etapa, você cria dois buckets do Amazon S3. O primeiro é um bucket de entrada para armazenar o código-fonte e o outro é um bucket de saída para armazenar a saída da compilação. Para obter mais informações, consulte [Criação, configuração e trabalho com buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) no *Guia do usuário do Amazon S3*.
1. Para criar o bucket de entrada, faça login no console do Amazon S3 e escolha **Criar bucket**.
1. Em **Configuração geral**, forneça um nome para o bucket e especifique Região da AWS onde você deseja criar o bucket. Um exemplo de nome é`codebuild-regionId-accountId-input-bucket`, where `regionId` is the Região da AWS do bucket e `accountId` é seu Conta da AWS ID.
**nota**
Se você estiver criando o bucket em um local diferente Região da AWS do Leste dos EUA (Norte da Virgínia), especifique o `LocationConstraint` parâmetro. Para obter mais informações, consulte [Criar Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) na *Referência da API do Amazon Simple Storage Service*.
1. Mantenha todas as outras configurações e escolha **Criar bucket.**
1. Repita as etapas de 1 a 3 para criar o bucket de saída. Um exemplo de nome é`codebuild-regionId-accountId-output-bucket`, where `regionId` is the Região da AWS do bucket e `accountId` é seu Conta da AWS ID.
Independentemente dos nomes que você escolher para esses buckets, não deixe de usá-los ao longo deste tutorial.
## Etapa 3: criar o arquivo de especificações de compilação
Nesta etapa, você cria um arquivo de especificações de compilação. Esse arquivo fornece comandos de compilação e configurações relacionadas, no formato YAML, CodeBuild para executar a compilação. Para obter mais informações, consulte a [referência da especificação de compilação CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) no *Guia AWS CodeBuild do usuário*.
1. Crie um arquivo chamado `buildspec.yml` no diretório que você descompactou como pré-requisito.
1. Adicione o seguinte conteúdo ao arquivo e salve. Nenhuma alteração é necessária para este arquivo.
```
version: 0.2
env:
exported-variables:
- CODEBUILD_BUILD_ID
- CODEBUILD_BUILD_ARN
phases:
install:
runtime-versions:
python: 3.7
pre_build:
commands:
- echo Installing source dependencies...
- ls -lR $CODEBUILD_SRC_DIR/source
build:
commands:
- echo Build started on `date`
- /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target
post_build:
commands:
- ls -lR $CODEBUILD_SRC_DIR/target
- echo Build completed on `date`
artifacts:
files:
- $CODEBUILD_SRC_DIR/target/**
```
Aqui`CODEBUILD_BUILD_ID`,`CODEBUILD_BUILD_ARN`,`$CODEBUILD_SRC_DIR/source`, e `$CODEBUILD_SRC_DIR/target` estão as variáveis de ambiente disponíveis em CodeBuild. Para obter mais informações, consulte [Variáveis de ambiente em ambientes de compilação](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html).
Nesse ponto, seu diretório deve ter a seguinte aparência.
```
(root directory name)
|-- build.xml
|-- buildspec.yml
|-- LICENSE.txt
|-- source
|... etc.
```
1. Compacte o conteúdo da pasta em um arquivo chamado `BankDemo.zip`. Para este tutorial, não é possível compactar a pasta. Em vez disso, compacte o conteúdo da pasta no arquivo `BankDemo.zip`.
## Etapa 4: fazer upload dos arquivos de origem
Nesta etapa, você carrega o código-fonte do aplicativo de BankDemo amostra no seu bucket de entrada do Amazon S3.
1. Faça login no console do Amazon S3 e escolha **Buckets** no painel de navegação esquerdo. Em seguida, escolha o bucket de entrada que você criou anteriormente.
1. Em **Objetos**, escolha **Carregar**.
1. Na seção **Arquivos e pastas**, escolha **Adicionar arquivos**.
1. Navegue e escolha seu arquivo `BankDemo.zip`.
1. Escolha **Carregar**.
## Etapa 5: criar políticas do IAM
Nesta etapa, você cria duas [políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Uma política concede permissões para a modernização do AWS mainframe acessar e usar a imagem do Docker que contém as ferramentas de construção da Rocket Software. Essa política não é personalizada para clientes. A outra política concede permissões para que a modernização do AWS mainframe interaja com os buckets de entrada e saída e com os [ CloudWatch registros da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) que são gerados. CodeBuild
Para saber mais sobre como criar uma política de IAM, consulte [Edição de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) no *Guia do usuário do IAM*.
**Para criar uma política para acessar imagens do Docker**
1. No console do IAM, copie o seguinte documento de política e cole-o no editor de políticas.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecr:GetAuthorizationToken"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ecr:BatchCheckLayerAvailability",
"ecr:GetDownloadUrlForLayer",
"ecr:BatchGetImage"
],
"Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::aws-m2-repo-*--prod"
}
]
}
```
------
1. Forneça um nome para a política, por exemplo, `m2CodeBuildPolicy`.
**Para criar uma política que permita que a modernização do AWS mainframe interaja com buckets e registros**
1. No console do IAM, copie o seguinte documento de política e cole-o no editor de políticas. Certifique-se de atualizar `regionId` para o Região da AWS, e `accountId` para o seu Conta da AWS.
1. Forneça um nome para a política, por exemplo, `BankdemoCodeBuildRolePolicy`.
## Etapa 6: criar um perfil do IAM
Nesta etapa, você cria uma nova [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que permite CodeBuild interagir com AWS os recursos para você, depois de associar as políticas do IAM que você criou anteriormente a essa nova função do IAM.
Para obter informações sobre a criação de uma função de serviço, consulte [Criação de uma função para delegar permissões a um AWS serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) no *Guia do usuário do IAM*,.
1. Faça login no console do IAM e escolha **Perfis** no painel de navegação esquerdo.
1. Selecione **Criar perfil**.
1. Em **Tipo de entidade confiável**, escolha **Serviço AWS**.
1. **Em Casos de uso para outros serviços da AWS**, escolha e **CodeBuild**, em seguida, escolha **CodeBuild**novamente.
1. Escolha **Próximo**.
1. Na página **Adicionar permissões**, escolha **Próximo**. Você atribui uma política à função posteriormente.
1. Em **Detalhes da função**, forneça um nome para a função, por exemplo,`BankdemoCodeBuildServiceRole`.
1. Em **Selecionar entidades confiáveis**, verifique se o documento de política tem a seguinte aparência:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "codebuild.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Selecione **Criar perfil**.
## Etapa 7: anexar as políticas do IAM ao perfil do IAM
Nesta etapa, você anexa as duas políticas do IAM que criou anteriormente ao perfil `BankdemoCodeBuildServiceRole` do IAM.
1. Faça login no console do IAM e escolha **Perfis** no painel de navegação esquerdo.
1. Em **Perfil do IAM**, escolha a função que você criou anteriormente, por exemplo, `BankdemoCodeBuildServiceRole`.
1. Em **Políticas de permissões**, escolha **Adicionar permissões** e, em seguida, **Anexar políticas**.
1. Em **Outras políticas de permissões**, escolha as políticas que você criou anteriormente, por exemplo, `m2CodeBuildPolicy` e `BankdemoCodeBuildRolePolicy`.
1. Escolha **Anexar políticas**.
## Etapa 8: criar o CodeBuild projeto
Nesta etapa, você cria o CodeBuild projeto.
1. Faça login no CodeBuild console e escolha **Criar projeto de compilação**.
1. Na seção **Configuração do projeto**, forneça um nome para o projeto, por exemplo, `codebuild-bankdemo-project`.
1. Na seção **Fonte**, em **Provedor de origem**, escolha **Amazon S3** e, em seguida, escolha o bucket de entrada que você criou anteriormente, por exemplo, `codebuild-regionId-accountId-input-bucket`.
1. No campo **Chave do objeto do S3 ou pasta do S3**, insira o nome do arquivo zip que você carregou no bucket do S3. Nesse caso, o nome do arquivo é `bankdemo.zip`.
1. Na seção **Ambiente**, escolha **Imagem personalizada**.
1. No campo **Tipo de ambiente**, escolha **Linux**.
1. Em **Registro de imagens**, escolha **Outro registro**.
1. No campo **URL do registro externo**,
+ Para Rocket Software v9: Entre. `673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1` Se você estiver usando uma AWS região diferente com o Rocket Software v9, você também pode especificar ` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1` onde está uma AWS região na qual o serviço de modernização de AWS mainframe está disponível (por exemplo,). `eu-west-3`
+ Para Rocket Software v8: Entrar `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
+ Para Rocket Software v7: Entrar `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10`
1. Em **Perfil de serviço**, escolha **Perfil de serviço existente** e, no campo **ARN o perfil**, escolha o perfil de serviço que você criou anteriormente; por exemplo, `BankdemoCodeBuildServiceRole`.
1. Na seção **Buildspec**, escolha **Usar um arquivo buildspec**.
1. Na seção **Artefatos**, em **Tipo**, escolha **Amazon** S3 e, em seguida, escolha seu bucket de saída, por exemplo, `codebuild-regionId-accountId-output-bucket`.
1. No campo **Nome**, insira o nome de uma pasta no bucket que você deseja que contenha os artefatos de saída da compilação, por exemplo, `bankdemo-output.zip`.
1. Em **Embalagem de artefatos**, escolha **Zip**.
1. Selecione **Create build project (Criar projeto de compilação)**.
## Etapa 9: iniciar a compilação
Nesta etapa, você inicia a compilação.
1. Faça login no CodeBuild console.
1. No painel de navegação esquerdo, selecione **Criar projetos**.
1. Escolha o projeto de compilação que você criou anteriormente, por exemplo, `codebuild-bankdemo-project`.
1. Selecione **Iniciar compilação**.
Esse comando inicia a compilação. A compilação é executada de forma assíncrona. A saída do comando é um JSON que inclui o id do atributo. Esse id de atributo é uma referência ao id de CodeBuild compilação da compilação que você acabou de iniciar. Você pode ver o status da compilação no CodeBuild console. Você também pode ver logs detalhados sobre a execução da compilação no console. Para obter mais informações, consulte [Exibir informações detalhadas da compilação](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html) no *Guia do usuário do AWS CodeBuild *.
Quando a fase atual for CONCLUÍDA, significa que sua compilação foi concluída com sucesso e que seus artefatos compilados estão prontos no Amazon S3.
## Etapa 10: baixar artefatos de saída
Nesta etapa, você baixa os artefatos de saída do Amazon S3. A ferramenta de construção da Rocket Software pode criar vários tipos diferentes de executáveis. Neste tutorial, ele gera objetos compartilhados.
1. Faça login no console do Amazon S3.
1. Na seção **Buckets** role="bold">, escolha o nome do bucket de saída, por exemplo, `codebuild-regionId-accountId-output-bucket`.
1. Escolha **Baixar** role="bold">.
1. Não descompacte o arquivo obtido por download. Navegue até a pasta de destino para ver os artefatos de compilação. Isso inclui os objetos compartilhados do `.so` Linux.
## Limpar os recursos
Se você não precisar mais dos recursos que criou para este tutorial, exclua-os para evitar cobranças adicionais. Para fazer isso, realize as etapas a seguir:
+ Exclua os buckets do S3 que você criou para este tutorial. Para obter mais informações, consulte [Excluir um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) no *Guia do usuário do Amazon Simple Storage Service*.
+ Exclua as políticas de IAM que você criou para este tutorial. Para obter mais informações, consulte [Exclusão de políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) no *Guia do usuário do IAM*.
+ Exclua o perfil do IAM que você criou para este tutorial. Para obter mais informações sobre como excluir uma função, consulte [Excluir funções ou perfis de instância](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) no *Manual do usuário do IAM*.
+ Exclua o CodeBuild projeto que você criou para este tutorial. Para obter mais informações, consulte [Excluir um projeto de compilação CodeBuild no](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html) *Guia AWS CodeBuild do usuário*.
# Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer
AWS A modernização do mainframe fornece várias ferramentas por meio do Amazon WorkSpaces Applications. WorkSpaces O Applications é um serviço de streaming de aplicativos totalmente gerenciado e seguro que permite transmitir aplicativos de desktop aos usuários sem reescrever os aplicativos. WorkSpaces Os aplicativos fornecem aos usuários acesso instantâneo aos aplicativos de que precisam, com uma experiência de usuário responsiva e fluida no dispositivo de sua escolha. O uso de WorkSpaces aplicativos para hospedar ferramentas específicas do mecanismo de tempo de execução oferece às equipes de aplicativos do cliente a capacidade de usar as ferramentas diretamente de seus navegadores da web, interagindo com arquivos de aplicativos armazenados em buckets ou repositórios do Amazon S3. CodeCommit
Para obter informações sobre o suporte de navegadores em WorkSpaces aplicativos, consulte [System Requirements and Feature Support (Web Browser)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) no *Amazon WorkSpaces Applications Administration Guide*. Se você tiver problemas ao usar WorkSpaces aplicativos, consulte [Solução de problemas de usuários AppStream 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) no *Guia de administração de WorkSpaces aplicativos da Amazon*.
Este documento é destinado aos membros da equipe de operações do cliente. Ele descreve como configurar frotas e pilhas da Amazon WorkSpaces Applications para hospedar as ferramentas Rocket Enterprise Analyzer e Rocket Enterprise Developer usadas com a modernização do mainframe. AWS O Rocket Enterprise Analyzer geralmente é usado durante a fase de avaliação e o Rocket Enterprise Developer geralmente é usado durante a fase de migração e modernização da abordagem de modernização do mainframe. AWS Se você planeja usar o Enterprise Analyzer e o Enterprise Developer, deve criar frotas e pilhas separadas para cada ferramenta. Cada ferramenta requer sua própria frota e pilha porque seus termos de licenciamento são diferentes.
**Importante**
As etapas deste tutorial são baseadas no CloudFormation modelo disponível para download [cfn-m2- .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). appstream-fleet-ea-ed
**Topics**
+ [Pré-requisitos](#tutorial-aas-prerequisites)
+ [Etapa 1: Obtenha as imagens dos WorkSpaces aplicativos](#tutorial-aas-step1)
+ [Etapa 2: criar a pilha usando o modelo CloudFormation](#tutorial-aas-step2)
+ [Etapa 3: criar um usuário nos WorkSpaces aplicativos](#tutorial-aas-step3)
+ [Etapa 4: Faça login nos WorkSpaces aplicativos](#tutorial-aas-step4)
+ [Etapa 5: verificar os buckets no Amazon S3 (opcional)](#tutorial-aas-step5)
+ [Próximas etapas](#tutorial-aas-next-steps)
+ [Limpar os recursos](#tutorial-aas-cleanup)
## Pré-requisitos
+ Faça o download do modelo: [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml.
+ Obtenha o ID da sua VPC e do grupo de segurança padrão. Para obter mais informações sobre a VPC padrão, consulte [Padrão VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) no Guia do usuário da Amazon *VPC*. Para ter mais informações sobre o grupo de segurança padrão, consulte [Grupos de segurança padrão e personalizados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) no *Guia do usuário do Amazon EC2*.
+ Certifique-se de que você tenha as seguintes permissões:
+ crie pilhas, frotas e usuários em WorkSpaces aplicativos.
+ crie pilhas CloudFormation usando um modelo.
+ crie buckets e faça upload de arquivos para buckets no Amazon S3.
+ baixe as credenciais (`access_key_id` e `secret_access_key`) do IAM.
## Etapa 1: Obtenha as imagens dos WorkSpaces aplicativos
Nesta etapa, você compartilha as imagens de WorkSpaces aplicativos do Enterprise Analyzer e do Enterprise Developer com sua AWS conta.
1. Abra o console de modernização do AWS mainframe em. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)
1. Na navegação à esquerda, selecione **Ferramentas**.
1. Em **Análise, desenvolvimento e criação de ativos**, escolha **Compartilhar ativos com minha AWS conta**.
## Etapa 2: criar a pilha usando o modelo CloudFormation
Nesta etapa, você usa o CloudFormation modelo baixado para criar uma pilha e uma frota de WorkSpaces aplicativos para executar o Rocket Enterprise Analyzer. Você pode repetir essa etapa posteriormente para criar outra pilha e frota de WorkSpaces aplicativos para executar o Rocket Enterprise Developer, pois cada ferramenta requer sua própria frota e pilha em aplicativos. WorkSpaces Para obter mais informações sobre CloudFormation pilhas, consulte Como [trabalhar com pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) no Guia do *AWS CloudFormation usuário*.
**nota**
AWS A modernização do mainframe adiciona uma taxa adicional ao preço padrão dos WorkSpaces aplicativos para o uso do Enterprise Analyzer e do Enterprise Developer. Para obter mais informações, consulte [Preço do AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/pricing/).
1. Faça o download do modelo [cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml), se necessário.
1. Abra o CloudFormation console e escolha **Criar pilha** e **com novos recursos (padrão)**.
1. Em **Pré-requisito — Preparar modelo**, selecione **O modelo está pronto**.
1. Em **Especificar modelo**, selecione **Upload de um arquivo de modelo**.
1. Em **Carregar um arquivo de modelo**, **escolha Escolher arquivo** e carregue o modelo [cfn-m2- appstream-fleet-ea-ed .yml.](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)
1. Escolha **Próximo**.
![\[A página CloudFormation Criar pilha com o modelo cfn-m2- appstream-fleet-ea-ed .yml selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/cfn-create-stack.png)
1. Em **Especificar detalhes da pilha**, insira as seguintes informações:
+ Em **Nome da pilha**, insira um nome de sua escolha. Por exemplo, .**m2-ea**
+ Em **AppStreamApplication**, escolha **chá**.
+ Em **AppStreamFleetSecurityGroup**, escolha o grupo de segurança padrão da sua VPC padrão.
+ Em **AppStreamFleetVpcSubnet**, escolha uma sub-rede em sua VPC padrão.
+ Em **AppStreamImageName**, escolha a imagem começando com`m2-enterprise-analyzer`. Essa imagem contém a versão atualmente suportada da ferramenta Rocket Enterprise Analyzer.
+ Aceite os padrões para os outros campos e selecione **Próximo**.
![\[A página de CloudFormation especificação de detalhes da pilha com as opções do Enterprise Analyzer preenchidas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/cfn-specify-stack-details.png)
1. Aceite todos os padrões e selecione **Próximo** novamente.
1. Na **revisão**, certifique-se de que todos os parâmetros sejam o que você pretende.
1. Role até o final, escolha **Eu reconheço que a AWS CloudFormation pode criar recursos do IAM com nomes personalizados** e escolha **Create Stack**.
A pilha e a frota demoram entre 20 e 30 minutos para serem criadas. Você pode escolher **Atualizar** para ver os CloudFormation eventos à medida que eles ocorrem.
## Etapa 3: criar um usuário nos WorkSpaces aplicativos
Enquanto espera CloudFormation a conclusão da criação da pilha, você pode criar um ou mais usuários em WorkSpaces Aplicativos. Esses usuários são aqueles que usarão o Enterprise Analyzer em WorkSpaces aplicativos. Você precisará especificar um endereço de e-mail para cada usuário e garantir que cada usuário tenha permissões suficientes para criar buckets no Amazon S3, fazer upload de arquivos em um bucket e vincular a um bucket para mapear seu conteúdo.
1. Abra o console de WorkSpaces aplicativos.
1. Na navegação à esquerda, selecione **Grupo de usuários**.
1. Selecione **Criar usuário**.
1. Forneça um endereço de e-mail onde o usuário possa receber um convite por e-mail para usar os WorkSpaces Aplicativos, um nome e sobrenome e escolha **Criar usuário**.
1. Repita, se necessário, para criar mais usuários. O endereço de e-mail de cada usuário deve ser exclusivo.
Para obter mais informações sobre a criação de usuários de WorkSpaces aplicativos, consulte [WorkSpaces Grupos de usuários](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) de aplicativos no *Guia de administração de WorkSpaces aplicativos da Amazon*.
Ao CloudFormation terminar de criar a pilha, você pode atribuir o usuário que você criou à pilha, da seguinte forma:
1. Abra o console de WorkSpaces aplicativos.
1. Clique no nome de usuário.
1. Escolha **Ação** e, em seguida, **Atribuir pilha**.
1. Em **Atribuir pilha**, escolha a pilha que começa com `m2-appstream-stack-ea`.
1. Escolha **Assign stack**.
![\[A página WorkSpaces Applications Assign stack mostrando um usuário e a pilha do Enterprise Analyzer a serem atribuídos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-assign-stack.png)
Atribuir um usuário a uma pilha faz com que os WorkSpaces Aplicativos enviem um e-mail para o usuário no endereço que você forneceu. Este e-mail contém um link para a página de login dos WorkSpaces aplicativos.
## Etapa 4: Faça login nos WorkSpaces aplicativos
Nesta etapa, você faz login nos WorkSpaces Aplicativos usando o link no e-mail enviado pelos WorkSpaces Aplicativos ao usuário em que você criou[Etapa 3: criar um usuário nos WorkSpaces aplicativos](#tutorial-aas-step3).
1. Faça login nos WorkSpaces Aplicativos usando o link fornecido no e-mail enviado pelos WorkSpaces Aplicativos.
1. Altere sua senha, se solicitado. A tela WorkSpaces Aplicativos que você vê é semelhante à seguinte:
![\[Um exemplo de tela de login de WorkSpaces aplicativos mostrando o ícone da área de trabalho.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-login-screen.png)
1. Escolha **Desktop**.
1. Na barra de tarefas, escolha **Pesquisar** e digite **D:** para navegar até a Pasta Pessoal.
**nota**
Se você pular essa etapa, poderá receber uma `Device not ready` mensagem de erro ao tentar acessar a Pasta Pessoal.
A qualquer momento, se você tiver problemas para entrar nos WorkSpaces Aplicativos, poderá reiniciar sua frota de WorkSpaces Aplicativos e tentar fazer login novamente, usando as etapas a seguir.
1. Abra o console de WorkSpaces aplicativos.
1. No painel de navegação à esquerda, escolha **Frotas**.
1. Escolha a frota que você está tentando usar.
1. Escolha **Ação** e, em seguida, escolha **Parar**.
1. Espere a frota parar.
1. Escolha **Ação** e, em seguida, escolha **Iniciar**.
Esse processo pode levar cerca de 10 minutos.
## Etapa 5: verificar os buckets no Amazon S3 (opcional)
Uma das tarefas concluídas pelo CloudFormation modelo que você usou para criar a pilha foi criar dois buckets no Amazon S3, que são necessários para salvar e restaurar os dados do usuário e as configurações do aplicativo em todas as sessões de trabalho. Esses buckets são os seguintes:
+ O nome começa com `appstream2-`. Esse bucket mapeia os dados para sua pasta inicial em WorkSpaces Applications (`D:\PhotonUser\My Files\Home Folder`).
**nota**
A Pasta Inicial é exclusiva para um determinado endereço de e-mail e é compartilhada entre todas as frotas e pilhas em uma determinada conta AWS . O nome da Pasta Pessoal é um SHA256 hash do endereço de e-mail do usuário e é armazenado em um caminho baseado nesse hash.
+ O nome começa com `appstream-app-settings-`. Esse bucket contém informações da sessão do usuário para WorkSpaces aplicativos e inclui configurações como favoritos do navegador, perfis de conexão do IDE e do aplicativo e personalizações da interface do usuário. Para obter mais informações, consulte [Como funciona a persistência das configurações do aplicativo](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) no *Amazon WorkSpaces Applications Administration Guide*.
Para verificar se os buckets foram criados, siga estas etapas:
1. Abra o console Amazon S3.
1. Na navegação à esquerda, escolha **Buckets**.
1. Em **Localizar compartimentos por nome**, insira **appstream** para filtrar a lista.
Não é necessário realizar nenhuma ação adicional se você ver os compartimentos. Esteja ciente de que os buckets existem. Se você não vê os buckets, significa que o CloudFormation modelo não terminou de ser executado ou ocorreu um erro. Acesse o CloudFormation console e revise as mensagens de criação da pilha.
## Próximas etapas
Agora que a infraestrutura de WorkSpaces aplicativos está configurada, você pode configurar e começar a usar o Enterprise Analyzer. Para obter mais informações, consulte [Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces](set-up-ea.md). Também é possível configurar o Enterprise Developer. Para obter mais informações, consulte [Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces](set-up-ed.md).
## Limpar os recursos
O procedimento para limpar a pilha e as frotas criadas é descrito em [Criar uma frota e uma pilha de WorkSpaces aplicativos](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html).
Quando os objetos de WorkSpaces aplicativos forem excluídos, o administrador da conta também poderá, se apropriado, limpar os buckets do Amazon S3 para configurações do aplicativo e pastas iniciais.
**nota**
A pasta inicial de um determinado usuário é exclusiva em todas as frotas, portanto, talvez seja necessário mantê-la se outras pilhas de WorkSpaces aplicativos estiverem ativas na mesma conta.
Por fim, WorkSpaces os aplicativos atualmente não permitem que você exclua usuários usando o console. Em vez disso, você deve usar a API de serviço com a CLI. Para obter mais informações, consulte [Administração de grupos de usuários](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) no *Amazon WorkSpaces Applications Administration Guide*.
# Tutorial: Use modelos com o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)
Este tutorial descreve como usar modelos e projetos predefinidos com o Rocket Enterprise Developer. Ele abrange três casos de uso. Todos os casos de uso usam o código de amostra fornecido na BankDemo amostra. Para baixar a amostra, escolha [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip).
**Importante**
Se você usar a versão do Enterprise Developer para Windows, os binários gerados pelo compilador poderão ser executados somente no Enterprise Server fornecido com o Enterprise Developer. Você não pode executá-los no tempo de execução da Modernização do AWS Mainframe, que é baseado no Linux.
**Topics**
+ [Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem](#tutorial-templates-ed-step1)
+ [Caso de uso 2 - Usando o modelo de projeto COBOL sem componentes de origem](#tutorial-templates-ed-step2)
+ [Caso de uso 3 - Usando o projeto COBOL predefinido vinculado às pastas de origem](#tutorial-templates-ed-step3)
+ [Usando o modelo JSON de definição de região](#tutorial-templates-ed-step4)
## Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem
Esse caso de uso exige que você copie os componentes de origem na estrutura de diretórios do modelo como parte das etapas de pré-configuração da demonstração. No, [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)isso foi alterado em relação à `AWSTemplates.zip` entrega original para evitar duas cópias da fonte.
1. Inicie o Enterprise Developer e especifique o espaço de trabalho escolhido.
![\[O lançador do Eclipse com um espaço de trabalho selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step1.png)
1. Na visualização do **Explorador de Aplicações**, no item de visualização em árvore **do Enterprise Development** Project, escolha **Novo projeto a partir do modelo** no menu de contexto.
![\[O menu de contexto da visualização em árvore do projeto de desenvolvimento corporativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step2.png)
1. Insira os parâmetros do modelo conforme indicado.
**nota**
O caminho do modelo se referirá ao local onde o ZIP foi extraído.
![\[A caixa Inserir parâmetros do modelo com o caminho e o nome do projeto preenchidos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step3.png)
1. Escolher OK criará um projeto Eclipse de desenvolvimento local com base no modelo fornecido, com uma estrutura completa do ambiente de origem e execução.
![\[O projeto Eclipse de desenvolvimento local mostrando sua estrutura.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step4.png)
A estrutura `System` contém um arquivo completo de definição de recursos com as entradas necessárias para o BANKDEMO, o catálogo necessário com entradas adicionadas e os arquivos de dados ASCII correspondentes.
Como a estrutura do modelo de origem contém todos os itens de origem, esses arquivos são copiados para o projeto local e, portanto, são criados automaticamente no Enterprise Developer.
## Caso de uso 2 - Usando o modelo de projeto COBOL sem componentes de origem
As etapas 1 a 3 são idênticas [Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem](#tutorial-templates-ed-step1) a.
A `System` estrutura nesse caso de uso também contém um arquivo completo de definição de recursos com as entradas necessárias para BankDemo, o catálogo necessário com entradas adicionadas e os arquivos de dados ASCII correspondentes.
No entanto, a estrutura de origem do modelo não contém nenhum componente. Você deve importá-los para o projeto a partir de qualquer repositório de origem que estiver usando.
1. Escolha o nome do projeto. No menu de contexto relacionado, escolha **Importar**.
![\[O menu de contexto do projeto com a importação selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step4.png)
1. Na caixa de diálogo resultante, na seção **Geral**, escolha **Sistema de arquivos** e, em seguida, escolha Próximo.
![\[A caixa Importar com o sistema de arquivos selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step5.png)
1. Preencha o campo **Do diretório** navegando no sistema de arquivos para apontar para a pasta do repositório. Escolha todas as pastas que você deseja importar, como `sources`. O `Into folder` campo será preenchido automaticamente. Escolha **Concluir**.
![\[A caixa Sistema de arquivos com o BankDemo diretório expandido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step6.png)
Depois que a estrutura do modelo de origem contém todos os itens de origem, eles são criados automaticamente no Enterprise Developer.
## Caso de uso 3 - Usando o projeto COBOL predefinido vinculado às pastas de origem
1. Inicie o Enterprise Developer e especifique o espaço de trabalho escolhido.
![\[O lançador do Eclipse com um espaço de trabalho selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step1.png)
1. No menu **File (Arquivo)**, escolha **Import (Importar)**.
![\[O menu Arquivo com a opção Importar selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step2.png)
1. Na caixa de diálogo resultante, em **Geral**, escolha **Projetos da pasta ou do arquivo** e escolha **Próximo**.
![\[A caixa Importar com projetos da pasta ou arquivo selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step3.png)
1. Preencha a **fonte de importação**, escolha o **diretório** e navegue pelo sistema de arquivos para selecionar a pasta predefinida do projeto. O projeto contido nele tem links para as pastas de origem no mesmo repositório.
![\[A importação de projetos do sistema de arquivos ou da caixa de arquivamento com o caminho para a fonte de importação inserido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step4.png)
Escolha **Terminar**.
Como o projeto é preenchido pelos links para a pasta de origem, o código é criado automaticamente.
## Usando o modelo JSON de definição de região
1. Alterne para a visualização Server Explorer. No menu de contexto relacionado, escolha **Abrir página de administração**, que inicia o navegador padrão.
![\[O menu de contexto do explorador de servidores com a página de administração aberta selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-admin-page.png)
1. Na tela resultante do Enterprise Server Common Web Administration (ESCWA), escolha **Importar**.
![\[A tela Enterprise Server Common Web Administration com a opção Importar selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-import.png)
1. Escolha o tipo de importação **JSON** e escolha **Avançar**.
![\[A caixa de escolha do tipo de importação com JSON selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-import-type.png)
1. Faça o upload do arquivo `BANKDEMO.JSON` fornecido.
![\[A caixa de escolha do arquivo para upload com o arquivo BANKDEMO selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-upload.png)
Depois de selecionado, escolha **Avançar**.
![\[A caixa de seleção de regiões com portas claras de endpoints não selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-next.png)
No painel **Selecionar regiões**, certifique-se de que a opção **Limpar portas dos endpoints** não esteja selecionada e continue escolhendo **Avançar nos** painéis até que o painel **Executar importação** seja exibido. Depois, escolha **Importar** no painel de navegação esquerdo.
Por fim, clique em **Concluir**. A região BANKDEMO será então adicionada à lista de servidores.
![\[A lista de regiões e servidores BankDemo foi adicionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-server-list.png)
1. Navegue até as **Propriedades Gerais** da região BANKDEMO.
1. Role até a seção **Configuration** (Configuração).
1. A variável de ambiente ESP precisa ser definida na `System` pasta relevante para o Projeto Eclipse criado nas etapas anteriores. Deve ser `workspacefolder/projectname/System`.
![\[A seção de configuração com a variável ESP mostrada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-ESP.png)
1. Clique em **Aplicar**.
A região agora está totalmente configurada para ser executada em conjunto com o projeto Eclipse COBOL.
1. Por fim, de volta ao Enterprise Developer, associe a região importada ao projeto.
![\[O menu de contexto do projeto com Associado ao projeto selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-associate.png)
O ambiente Enterprise Developer agora está pronto para uso, com uma versão funcional completa do BankDemo. Você pode editar, compilar e depurar o código na região.
**Importante**
Se você usar a versão do Enterprise Developer para Windows, os binários gerados pelo compilador poderão ser executados somente no Enterprise Server fornecido com o Enterprise Developer. Você não pode executá-los no tempo de execução da Modernização do AWS Mainframe, que é baseado no Linux.
# Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces
Este tutorial descreve como configurar o Rocket Enterprise Analyzer (antigo Micro Focus Enterprise Analyzer) para analisar um ou mais aplicativos de mainframe. A ferramenta Enterprise Analyzer fornece vários relatórios com base em sua análise do código-fonte da aplicação e das definições do sistema.
Essa configuração foi projetada para promover a colaboração em equipe. A instalação usa um bucket do Amazon S3 para compartilhar o código-fonte com discos virtuais. Isso faz uso do [Rclone](https://rclone.org/)) na máquina Windows. Com uma instância comum do Amazon RDS executando o [PostgreSQL](https://www.postgresql.org/), qualquer membro da equipe pode acessar todos os relatórios solicitados.
Os membros da equipe também podem montar o disco virtual com suporte do Amazon S3 em suas máquinas pessoais e atualizar o bucket de origem a partir de suas estações de trabalho. Eles podem potencialmente usar scripts ou qualquer outra forma de automação em suas máquinas se estiverem conectados a outros sistemas internos locais.
A configuração é baseada nas imagens do WorkSpaces Applications Windows que a AWS Mainframe Modernization compartilha com o cliente. A configuração também se baseia na criação de frotas e pilhas de WorkSpaces aplicativos, conforme descrito em. [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md)
**Importante**
As etapas deste tutorial pressupõem que você configure WorkSpaces aplicativos com o CloudFormation modelo disponível para download [cfn-m2- .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). appstream-fleet-ea-ed Para obter mais informações, consulte [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md).
Para executar as etapas neste tutorial, você deve ter configurado a frota e a pilha do Enterprise Analyzer e elas devem estar em execução.
Para obter uma descrição completa dos recursos e resultados do Enterprise Analyzer, consulte a [documentação do Enterprise Analyzer](https://www.microfocus.com/documentation/enterprise-analyzer/) no site da Rocket Software (antiga Micro Focus).
## Conteúdo da imagem
Além da própria aplicação Enterprise Analyzer, a imagem contém as seguintes ferramentas e bibliotecas.
Ferramentas de terceiros
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC driver](https://odbc.postgresql.org/)
Bibliotecas em `C:\Users\Public`
+ BankDemo código-fonte e definição do projeto para Enterprise Developer:`m2-bankdemo-template.zip`.
+ Pacote de instalação do MFA para o mainframe: `mfa.zip`. Para obter mais informações, consulte [Visão geral do acesso ao mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) na documentação do *Micro Focus Enterprise Developer*.
+ Arquivos de comando e configuração do Rclone (instruções para seu uso nos tutoriais): `m2-rclone.cmd` e `m2-rclone.conf`.
**Topics**
+ [Conteúdo da imagem](#set-up-ea-image-contents)
+ [Pré-requisitos](#tutorial-ea-prerequisites)
+ [Etapa 1: configuração](#tutorial-ea-step1)
+ [Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows](#tutorial-ea-step2)
+ [Etapa 3: criar uma fonte de ODBC para a instância do Amazon RDS](#tutorial-ea-step3)
+ [Sessões subsequentes](#tutorial-ea-step4)
+ [Solução de problemas de conexão do espaço de trabalho](#tutorial-ea-step5)
+ [Limpar os recursos](#tutorial-ea-clean)
## Pré-requisitos
+ Faça upload do código-fonte e das definições do sistema para a aplicação do cliente que você deseja analisar em um bucket do S3. As definições do sistema incluem CICS CSD, definições de DB2 objetos e assim por diante. Você pode criar uma estrutura de pastas dentro do bucket que faça sentido para a forma como você deseja organizar os artefatos da aplicação. Por exemplo, quando você descompacta a BankDemo amostra, ela tem a seguinte estrutura:
```
demo
|--> jcl
|--> RDEF
|--> transaction
|--> xa
```
+ Crie e inicie uma instância do Amazon RDS executando PostgreSQL. Essa instância armazenará os dados e os resultados produzidos pelo Enterprise Analyzer. Você pode compartilhar essa instância com todos os membros da equipe da aplicação. Além disso, crie um esquema vazio chamado `m2_ea` (ou qualquer outro nome adequado) no banco de dados. Defina credenciais para usuários autorizados que lhes permitam criar, inserir, atualizar e excluir itens nesse esquema. Você pode obter o nome do banco de dados, o URL do endpoint do servidor e a porta TCP no console do Amazon RDS ou no administrador da conta.
+ Certifique-se de ter configurado o acesso programático ao seu Conta da AWS. Para obter mais informações, consulte [Acesso programático](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) no *Referência geral da Amazon Web Services*.
## Etapa 1: configuração
1. Inicie uma sessão com WorkSpaces Aplicativos com a URL que você recebeu na mensagem de e-mail de boas-vindas dos WorkSpaces Aplicativos.
1. Use seu e-mail como ID de usuário e defina sua senha permanente.
1. Selecione a pilha do Enterprise Analyzer.
1. Na página do menu WorkSpaces Aplicativos, escolha **Área de trabalho** para acessar a área de trabalho do Windows que a frota está transmitindo.
## Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows
**nota**
Se você já usou o Rclone durante a pré-visualização da modernização do AWS mainframe, você deve atualizar `m2-rclone.cmd` para a versão mais recente localizada em. `C:\Users\Public`
1. Copie os arquivos `m2-rclone.conf` e `m2-rclone.cmd` fornecidos em `C:\Users\Public` para sua pasta pessoal `C:\Users\PhotonUser\My Files\Home Folder` usando o Explorador de Arquivos.
1. Atualize os parâmetros de `m2-rclone.conf` configuração com sua chave de AWS acesso e o segredo correspondente, bem como seu Região da AWS.
```
[m2-s3]
type = s3
provider = AWS
access_key_id = YOUR-ACCESS-KEY
secret_access_key = YOUR-SECRET-KEY
region = YOUR-REGION
acl = private
server_side_encryption = AES256
```
1. Mo `m2-rclone.cmd`, faça as seguintes alterações:
+ Altere `amzn-s3-demo-bucket` para o nome do seu bucket do Amazon S3. Por exemplo, .`m2-s3-mybucket`
+ Altere `your-s3-folder-key` para sua chave de bucket do Amazon S3. Por exemplo, .`myProject`
+ Altere `your-local-folder-path` para o caminho do diretório em que você deseja que os arquivos da aplicação sejam sincronizados a partir do bucket do Amazon S3 que os contém. Por exemplo, .`D:\PhotonUser\My Files\Home Folder\m2-new` Esse diretório sincronizado deve ser um subdiretório da Pasta Inicial para que os WorkSpaces Aplicativos possam fazer backup e restaurá-lo adequadamente no início e no final da sessão.
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
goto :loop
```
1. Abra um prompt de comando do Windows, toque em CD, `C:\Users\PhotonUser\My Files\Home Folder` se necessário, e execute`m2-rclone.cmd`. Esse script de comando executa um loop contínuo, sincronizando o bucket e a chave do Amazon S3 com a pasta local a cada 10 segundos. Você pode ajustar o tempo limite conforme necessário. Você deve ver o código-fonte da aplicação localizado no bucket do Amazon S3 no Windows File Explorer.
Para adicionar novos arquivos ao conjunto em que você está trabalhando ou para atualizar os existentes, faça o upload dos arquivos para o bucket do Amazon S3 e eles serão sincronizados com seu diretório na próxima iteração definida em `m2-rclone.cmd`. Da mesma forma, se quiser excluir alguns arquivos, exclua-os do bucket do Amazon S3. A próxima operação de sincronização os excluirá do seu diretório local.
## Etapa 3: criar uma fonte de ODBC para a instância do Amazon RDS
1. Para iniciar a ferramenta EA\$1Admin, navegue até o menu seletor de aplicações no canto superior esquerdo da janela do navegador e escolha **MF EA\$1Admin.**
1. No menu **Administrar**, escolha **Fontes de dados ODBC** e escolha **Adicionar** na guia **DSN do usuário**.
1. Na caixa de diálogo Criar nova fonte de dados, escolha o driver **PostgreSQL Unicode** e, em seguida, selecione **Concluir**.
1. Na caixa de diálogo **Configuração do driver ODBC PostgreSQL Unicode (psqlODBC)**, defina e anote o nome da fonte de dados que você deseja. Preencha os seguintes parâmetros com os valores da instância do RDS que você criou anteriormente:
**Description**
Descrição opcional para ajudá-lo a identificar essa conexão de banco de dados rapidamente.
**Banco de dados**
O banco de dados do Amazon RDS que você criou anteriormente.
**Servidor**
O endpoint do Amazon RDS.
**Porta**
A porta do Amazon RDS.
**Nome de usuário**
Conforme definido na instância do Amazon RDS.
**Senha**
Conforme definido na instância do Amazon RDS.
1. Escolha **Testar** para validar se a conexão com o Amazon RDS foi bem-sucedida e, em seguida, escolha **Salvar** para salvar seu novo DSN de usuário.
1. Espere até ver a mensagem que confirma a criação do espaço de trabalho adequado e, em seguida, escolha **OK** para finalizar com as fontes de dados ODBC e fechar a ferramenta EA\$1Admin.
1. Navegue novamente até o menu do seletor de aplicações e escolha Enterprise Analyzer para iniciar a ferramenta. Selecione **Criar novo**.
1. Na janela de configuração do espaço de trabalho, insira o nome do espaço de trabalho e defina sua localização. O espaço de trabalho pode ser o disco baseado no Amazon S3, se você trabalhar com essa configuração, ou sua pasta inicial, se preferir.
1. Escolha **Escolher outro banco de dados** para se conectar à sua instância do Amazon RDS.
1. Escolha o ícone do **Postgre** nas opções e, depois, escolha **OK**.
1. Para as configurações do Windows, em **Opções — Definir parâmetros de conexão**, insira o nome da fonte de dados que você criou. Insira também o nome do banco de dados, o nome do esquema, o nome do usuário e a senha. Escolha **OK**.
1. Aguarde até que o Enterprise Analyzer crie todas as tabelas, índices, etc. necessários para armazenar os resultados. Essa etapa pode levar alguns minutos. O Enterprise Analyzer confirma quando o banco de dados e o espaço de trabalho estão prontos para uso.
1. Navegue novamente até o menu do seletor de aplicações e escolha Enterprise Analyzer para iniciar a ferramenta.
1. A janela de inicialização do Enterprise Analyzer aparece no novo local selecionado do espaço de trabalho. Escolha **OK**.
1. Navegue até seu repositório no painel esquerdo, selecione o nome do repositório e escolha **Adicionar arquivos/pastas ao seu espaço de trabalho**. Selecione a pasta em que o código da aplicação está armazenado para adicioná-lo ao espaço de trabalho. Você pode usar o código de BankDemo exemplo anterior, se quiser. Quando o Enterprise Analyzer solicitar que você verifique esses arquivos, escolha **Verificar** para iniciar o relatório de verificação inicial do Enterprise Analyzer. A conclusão pode levar alguns minutos, dependendo do tamanho da aplicação.
1. Expanda seu espaço de trabalho para ver os arquivos e pastas que você adicionou ao espaço de trabalho. Os tipos de objetos e os relatórios de complexidade ciclomática também são visíveis no quadrante superior do painel **Visualizador de gráficos**.
Agora você pode usar o Enterprise Analyzer para todas as tarefas necessárias.
## Sessões subsequentes
1. Inicie uma sessão com WorkSpaces Aplicativos com a URL que você recebeu na mensagem de e-mail de boas-vindas dos WorkSpaces Aplicativos.
1. Faça login com seu e-mail e senha permanente.
1. Selecione a pilha do Enterprise Analyzer.
1. Inicie `Rclone` para se conectar ao disco suportado pelo Amazon S3 se você usar essa opção para compartilhar os arquivos do espaço de trabalho.
1. Inicie o Enterprise Analyzer para fazer suas tarefas.
## Solução de problemas de conexão do espaço de trabalho
Ao tentar se reconectar ao seu espaço de trabalho do Enterprise Analyzer, você pode ver um erro como este:
```
Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?
```
Para resolver esse problema, escolha **OK** para limpar a mensagem e conclua as etapas a seguir.
1. Em WorkSpaces Aplicativos, escolha o ícone **Iniciar Aplicativo** na barra de ferramentas e, em seguida, escolha **EA\$1Admin** para iniciar a ferramenta de administração do Enterprise Analyzer.
![\[O menu seletor de inicialização de WorkSpaces aplicativos com a ferramenta de administração do Rocket Enterprise Developer selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-launch-selector.png)
1. No menu **Administrar**, escolha **Atualizar caminho do espaço de trabalho…**.
![\[Menu de administração da ferramenta de administração do Rocket Enterprise Analyzer com a opção Refresh Workspace Path selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-administer-refresh.png)
1. Em **Selecionar espaço de trabalho**, escolha o espaço de trabalho desejado e, em seguida, escolha **OK**.
![\[A caixa de diálogo Selecionar espaço de trabalho da ferramenta de administração do Rocket Enterprise Analyzer com um projeto selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-select-workspace.png)
1. Escolha **OK** para confirmar a mensagem de erro.
![\[A mensagem de erro do Enterprise Analyzer “Não é possível acessar o diretório do espaço de trabalho” com a opção OK selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-select-workspace-error.png)
1. Em **Caminho de rede do diretório Workspace**, insira o caminho correto para seu espaço de trabalho, por exemplo, `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`.
![\[A caixa de diálogo Enterprise Analyzer Caminho de rede do diretório Workspace com um exemplo de caminho.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)
1. Feche a ferramenta de administração do Micro Focus Enterprise Analyzer.
![\[A ferramenta de administração do Micro Focus Enterprise Analyzer com o botão Fechar selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-close.png)
1. Em WorkSpaces Aplicativos, escolha o ícone **Iniciar aplicativo** na barra de ferramentas e, em seguida, escolha **EA** para iniciar o Micro Focus Enterprise Analyzer.
![\[O ícone de lançamento do aplicativo de WorkSpaces aplicativos com o EA selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-launch-ea.png)
1. Repita as etapas de 3 a 5.
O Micro Focus Enterprise Analyzer agora deve abrir com o espaço de trabalho existente.
## Limpar os recursos
Se os recursos criados durante este tutorial não forem mais necessários, exclua-os para não incorrer em cobranças adicionais. Execute as etapas a seguir:
+ Use a ferramenta **EA\$1Admin** para excluir o espaço de trabalho.
+ Exclua os buckets do S3 que você criou para este tutorial. Para obter mais informações, consulte [Exclusão de um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) no *Guia do usuário do Amazon S3*.
+ Exclua o banco de dados que você criou para este tutorial. Para ter mais informações, consulte [Excluir uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).
# Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces
Este tutorial descreve como configurar o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer) para um ou mais aplicativos de mainframe a fim de mantê-los, compilá-los e testá-los usando os recursos do Enterprise Developer. A configuração é baseada nas imagens do WorkSpaces Applications Windows que a AWS Mainframe Modernization compartilha com o cliente e na criação de frotas e pilhas de WorkSpaces aplicativos, conforme descrito em. [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md)
**Importante**
As etapas deste tutorial pressupõem que você configure WorkSpaces aplicativos usando o CloudFormation modelo disponível para download [cfn-m2- .yaml](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml). appstream-fleet-ea-ed Para obter mais informações, consulte [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md).
Você deve executar as etapas dessa configuração quando a frota e a pilha do Enterprise Developer estiverem em funcionamento.
Para obter uma descrição completa dos recursos e resultados do Enterprise Developer v7, confira sua [documentação up-to-date on-line (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) no site da Rocket Software (antiga Micro Focus).
## Conteúdo da imagem
Além do próprio Enterprise Developer, a imagem contém a imagem que contém o Rumba (um TN3270 emulador). Ele também contém as seguintes ferramentas e bibliotecas.
Ferramentas de terceiros
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC driver](https://odbc.postgresql.org/)
Bibliotecas em `C:\Users\Public`
+ BankDemo código-fonte e definição do projeto para Enterprise Developer:`m2-bankdemo-template.zip`.
+ Pacote de instalação do MFA para o mainframe: `mfa.zip`. Para obter mais informações, consulte [Visão geral do acesso ao mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) na documentação do *Micro Focus Enterprise Developer*.
+ Arquivos de comando e configuração do Rclone (instruções para seu uso nos tutoriais): `m2-rclone.cmd` e `m2-rclone.conf`.
Se você precisar acessar o código-fonte que ainda não está carregado nos CodeCommit repositórios, mas que está disponível em um bucket do Amazon S3, por exemplo, para realizar o carregamento inicial do código-fonte no git, siga o procedimento para criar um disco virtual do Windows conforme descrito em. [Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces](set-up-ea.md)
**Topics**
+ [Conteúdo da imagem](#set-up-ed-image-contents)
+ [Pré-requisitos](#tutorial-ed-prerequisites)
+ [Etapa 1: configuração por usuários individuais do Enterprise Developer](#tutorial-ed-step1)
+ [Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows (opcional)](#tutorial-ed-step2)
+ [Etapa 3: clonar o repositório](#tutorial-ed-step3)
+ [Sessões subsequentes](#tutorial-ed-step4)
+ [Limpar os recursos](#tutorial-ed-clean)
## Pré-requisitos
+ Um ou mais CodeCommit repositórios carregados com o código-fonte do aplicativo a ser mantido. A configuração do repositório deve corresponder aos requisitos do CI/CD pipeline acima para criar sinergias por meio da combinação das duas ferramentas.
+ Cada usuário deve ter credenciais para o CodeCommit repositório ou repositórios definidos pelo administrador da conta de acordo com as informações em [Autenticação e controle de acesso](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) da AWS. CodeCommit A estrutura dessas credenciais é revisada em [Autenticação e controle de acesso para AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) e a referência completa para autorizações do IAM CodeCommit está na [referência de CodeCommit permissões](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): o administrador pode definir políticas distintas do IAM para funções distintas, tendo credenciais específicas para a função de cada repositório e limitando suas autorizações do usuário ao conjunto específico de tarefas que ele precisa realizar em um determinado repositório. Portanto, para cada mantenedor do CodeCommit repositório, o administrador da conta gerará um usuário primário e concederá a esse usuário permissões para acessar o repositório ou repositórios necessários selecionando a política ou as políticas adequadas do IAM para acesso. CodeCommit
## Etapa 1: configuração por usuários individuais do Enterprise Developer
1. Obtenha suas credenciais do IAM:
1. Conecte-se ao AWS console em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Siga o procedimento descrito na etapa 3 de [Configuração para usuários HTTPS usando credenciais do Git](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) no *Guia do usuário AWS CodeCommit *.
1. Copie as credenciais de CodeCommit login específicas que o IAM gerou para você, mostrando, copiando e colando essas informações em um arquivo seguro em seu computador local ou escolhendo **Baixar credenciais para baixar** essas informações como um arquivo.CSV. Essas informações são necessárias para você se conectar ao CodeCommit.
1. Inicie uma sessão com WorkSpaces aplicativos com base na URL recebida no e-mail de boas-vindas. Use seu e-mail como nome de usuário e crie sua senha.
1. Selecione sua pilha de desenvolvedores corporativos.
1. Na página do menu, escolha **Desktop** para acessar a área de trabalho do Windows transmitida pela frota.
## Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows (opcional)
Se houver necessidade do Rclone (veja acima), crie a pasta virtual baseada no Amazon S3 no Windows: (opcional se todos os artefatos do aplicativo vierem exclusivamente do acesso). CodeCommit
**nota**
Se você já usou o Rclone durante a pré-visualização da modernização do AWS mainframe, você deve atualizar `m2-rclone.cmd` para a versão mais recente localizada em. `C:\Users\Public`
1. Copie os arquivos `m2-rclone.conf` e `m2-rclone.cmd` fornecidos em `C:\Users\Public` para sua pasta pessoal `C:\Users\PhotonUser\My Files\Home Folder` usando o Explorador de Arquivos.
1. Atualize os parâmetros de `m2-rclone.conf` configuração com sua chave de AWS acesso e o segredo correspondente, bem como seu Região da AWS.
```
[m2-s3]
type = s3
provider = AWS
access_key_id = YOUR-ACCESS-KEY
secret_access_key = YOUR-SECRET-KEY
region = YOUR-REGION
acl = private
server_side_encryption = AES256
```
1. Mo `m2-rclone.cmd`, faça as seguintes alterações:
+ Altere `amzn-s3-demo-bucket` para o nome do seu bucket do Amazon S3. Por exemplo, .`m2-s3-mybucket`
+ Altere `your-s3-folder-key` para sua chave de bucket do Amazon S3. Por exemplo, .`myProject`
+ Altere `your-local-folder-path` para o caminho do diretório em que você deseja que os arquivos da aplicação sejam sincronizados a partir do bucket do Amazon S3 que os contém. Por exemplo, .`D:\PhotonUser\My Files\Home Folder\m2-new` Esse diretório sincronizado deve ser um subdiretório da Pasta Inicial para que os WorkSpaces Aplicativos possam fazer backup e restaurá-lo adequadamente no início e no final da sessão.
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
goto :loop
```
1. Abra um prompt de comando do Windows, toque em CD, `C:\Users\PhotonUser\My Files\Home Folder` se necessário, e execute`m2-rclone.cmd`. Esse script de comando executa um loop contínuo, sincronizando o bucket e a chave do Amazon S3 com a pasta local a cada 10 segundos. Você pode ajustar o tempo limite conforme necessário. Você deve ver o código-fonte da aplicação localizado no bucket do Amazon S3 no Windows File Explorer.
Para adicionar novos arquivos ao conjunto em que você está trabalhando ou para atualizar os existentes, faça o upload dos arquivos para o bucket do Amazon S3 e eles serão sincronizados com seu diretório na próxima iteração definida em `m2-rclone.cmd`. Da mesma forma, se quiser excluir alguns arquivos, exclua-os do bucket do Amazon S3. A próxima operação de sincronização os excluirá do seu diretório local.
## Etapa 3: clonar o repositório
1. Navegue até o menu seletor de aplicações no canto superior esquerdo da janela do navegador e selecione Enterprise Developer.
1. Conclua a criação do espaço de trabalho exigido pelo Enterprise Developer em sua pasta inicial escolhendo `C:\Users\PhotonUser\My Files\Home Folder` (aka `D: \PhotonUser\My Files\Home Folder`) como local para o espaço de trabalho.
1. ****No Enterprise Developer, clone seu CodeCommit repositório acessando o Project Explorer, clique com o botão direito do mouse e escolha **Importar, Importar****...**, Git, Projetos **do** **Git** Clone URI.**** Em seguida, insira suas credenciais CodeCommit de login específicas e preencha a caixa de diálogo do Eclipse para importar o código.
O repositório CodeCommit git agora está clonado em seu espaço de trabalho local.
Seu espaço de trabalho do Enterprise Developer agora está pronto para iniciar o trabalho de manutenção em sua aplicação. Em particular, você pode usar a instância local do Enterprise Server (ES) integrada ao Enterprise Developer para depurar e executar interativamente seu aplicativo para validar suas alterações localmente.
**nota**
O ambiente local do Enterprise Developer, incluindo a instância local do Enterprise Server, é executado no Windows, enquanto a modernização do AWS mainframe é executada no Linux. Recomendamos que você execute testes complementares no ambiente Linux fornecido pela AWS Mainframe Modernization depois de confirmar o novo aplicativo CodeCommit e reconstruí-lo para esse destino e antes de implantar o novo aplicativo em produção.
## Sessões subsequentes
Ao selecionar uma pasta que está sob gerenciamento de WorkSpaces aplicativos, como a pasta inicial para a clonagem do seu CodeCommit repositório, ela será salva e restaurada de forma transparente em todas as sessões. Conclua as seguintes etapas na próxima vez que precisar trabalhar com a aplicação:
1. Inicie uma sessão com WorkSpaces aplicativos com base na URL recebida no e-mail de boas-vindas.
1. Faça login com seu e-mail e senha permanente.
1. Selecione a pilha Enterprise Developer.
1. Inicie `Rclone` para se conectar (veja acima) ao disco baseado no Amazon S3 quando essa opção for usada para compartilhar os arquivos do espaço de trabalho.
1. Inicie o Enterprise Developer para fazer seu trabalho.
## Limpar os recursos
Se os recursos criados durante este tutorial não forem mais necessários, exclua-os para que você não continue sendo cobrado por eles. Execute as etapas a seguir:
+ Exclua o CodeCommit repositório que você criou para este tutorial. Para obter mais informações, consulte [Excluir um CodeCommit repositório](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) no *Guia do AWS CodeCommit usuário*.
+ Exclua o banco de dados que você criou para este tutorial. Para ter mais informações, consulte [Excluir uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).
# Utilitários em lote disponíveis na modernização do AWS mainframe
Os aplicativos de mainframe geralmente usam programas utilitários em lote para executar funções específicas, como classificar dados, transferir arquivos usando FTP, carregar dados em bancos de dados DB2, como descarregar dados de bancos de dados e assim por diante.
Ao migrar seus aplicativos para a modernização do AWS mainframe, você precisa de utilitários de substituição funcionalmente equivalentes que possam realizar as mesmas tarefas que os usados no mainframe. Alguns desses utilitários podem já estar disponíveis como parte dos mecanismos de tempo de execução da modernização do AWS mainframe, mas estamos fornecendo os seguintes utilitários substitutos:
+ M2SFTP: permite a transferência segura de arquivos usando o protocolo SFTP.
+ M2WAIT: espera por um período de tempo especificado antes de continuar com a próxima etapa em um trabalho em lotes.
+ TXT2PDF - converte arquivos de texto em formato PDF.
+ M2DFUTIL: que fornece funções de backup, restauração, exclusão e cópia em conjuntos de dados, semelhantes ao suporte fornecido pelo utilitário ADRDSSU de mainframe.
+ M2RUNCMD - permite executar comandos, scripts e chamadas de sistema da Rocket Software (antiga Micro Focus) diretamente da JCL.
Desenvolvemos esses utilitários em lote com base no feedback dos clientes e os projetamos para fornecer a mesma funcionalidade dos utilitários de mainframe. O objetivo é fazer com que sua transição do mainframe para a modernização do AWS mainframe seja a mais tranquila possível.
**Topics**
+ [Localização binário](#location-utilities)
+ [Utilitário em lote M2SFTP](m2sftp.md)
+ [Utilitário em lote M2WAIT](m2wait.md)
+ [TXT2Utilitário de lote de](txt2pdf.md)
+ [Utilitário em lote M2DFUTIL](m2dfutil.md)
+ [Utilitário em lote M2RUNCMD](m2runcmd.md)
## Localização binário
Esses utilitários estão pré-instalados nos produtos Rocket Enterprise Developer (ED) e Rocket Software (ES). Você pode encontrá-los no seguinte local para todas as variantes de ED e ES:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit`
# Utilitário em lote M2SFTP
O M2SFTP é um programa utilitário JCL projetado para realizar transferências seguras de arquivos entre sistemas usando o Secure File Transfer Protocol (SFTP). O programa usa o cliente Putty SFTP, `psftp`, para realizar as transferências reais de arquivos. O programa funciona de forma semelhante a um programa utilitário de FTP de mainframe e usa autenticação de usuário e senha.
**nota**
A autenticação de chave pública não é compatível.
Para converter seu mainframe FTP JCLs para usar SFTP, mude para. `PGM=FTP` `PGM=M2SFTP`
**Topics**
+ [Plataformas compatíveis](#m2sftp-platforms)
+ [Instalar as dependências](#m2sftp-dependencies)
+ [Configurar o M2SFTP para AWS a modernização gerenciada do mainframe](#m2sftp-configure-managed)
+ [Configurar o M2SFTP para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Amostra JCLs](#m2sftp-jcl)
+ [Referência de comando do cliente Putty SFTP (PSFTP)](#m2sftp-cmd-ref)
+ [Próximas etapas](#m2sftp-next)
## Plataformas compatíveis
Você pode usar o M2SFTP em qualquer uma das seguintes plataformas:
+ AWS Software de modernização de mainframe Rocket (anteriormente Micro Focus) gerenciado
+ Rocket Software Runtime (no Amazon EC2)
+ Todas as variantes dos produtos Rocket Software Enterprise Developer (ED) e Rocket Software Enterprise Server (ES).
## Instalar as dependências
**Para instalar o cliente Putty SFTP no Windows**
+ Faça o download do cliente [PuTTY SFTP](https://www.putty.org/) e instale-o.
**Para instalar o cliente Putty SFTP no Linux:**
+ Execute o seguinte comando para instalar o cliente SFTP do Putty:
```
sudo yum -y install putty
```
## Configurar o M2SFTP para AWS a modernização gerenciada do mainframe
Se seus aplicativos migrados estiverem sendo executados no AWS Mainframe Modernization Managed, você precisará configurar o M2SFTP da seguinte forma.
+ Defina as variáveis de ambiente apropriadas do Rocket Enterprise Server para MFFTP. Aqui estão alguns exemplos:
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ `MFFTP_ABEND`
Você pode definir quantas ou quantas dessas variáveis quiser. Você pode configurá-los em seu JCL usando a `ENVAR DD` instrução. Para obter mais informações sobre essas variáveis, consulte Variáveis de [controle do MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) na documentação da Micro Focus.
Para testar sua configuração, consulte [Amostra JCLs](#m2sftp-jcl).
## Configurar o M2SFTP para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces
Se seus aplicativos migrados estiverem sendo executados em tempo de execução de modernização de AWS mainframe no Amazon EC2, configure o M2SFTP da seguinte forma.
1. Altere o [caminho do programa Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir a localização binária dos utilitários em lote. Se você precisar especificar vários caminhos, use dois pontos (`:`) para separar caminhos no Linux e ponto e vírgula (`;`) no Windows.
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. Defina as variáveis de ambiente apropriadas do Rocket Enterprise Server para MFFTP. Aqui estão alguns exemplos:
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ ``MFFTP\$1ABEND
Você pode definir quantas ou quantas dessas variáveis quiser. Você pode configurá-los em seu JCL usando a `ENVAR DD` instrução. Para obter mais informações sobre essas variáveis, consulte Variáveis de [controle do MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) na documentação da Micro Focus.
Para testar sua configuração, consulte [Amostra JCLs](#m2sftp-jcl).
## Amostra JCLs
Para testar a instalação, você pode usar um dos seguintes arquivos JCL de exemplo.
**M2 SFTP1 .jcl**
Este JCL mostra como chamar o M2SFTP para enviar um arquivo para um servidor SFTP remoto. Observe as variáveis de ambiente definidas na `ENVVAR DD` instrução.
```
//M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to send a file to SFTP server*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP,
// PARM='127.0.0.1 (EXIT=99 TIMEOUT 300'
//*
//SYSFTPD DD *
RECFM FB
LRECL 80
SBSENDEOL CRLF
MBSENDEOL CRLF
TRAILINGBLANKS FALSE
/*
//NETRC DD *
machine 127.0.0.1 login sftpuser password sftppass
/*
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//INPUT DD *
type a
locsite notrailingblanks
cd files
put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf
put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt
quit
/*
//ENVVAR DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```
**M2 SFTP2 .jcl**
Este JCL mostra como chamar o M2SFTP para receber um arquivo de um servidor SFTP remoto. Observe as variáveis de ambiente definidas na `ENVVAR DD` declaração.
```
//M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to receive a file from SFTP server*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP
//*
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//INPUT DD *
open 127.0.0.1
sftpuser
sftppass
cd files
locsite recfm=fb lrecl=150
get AWS.M2.CARDDEMO.CARDDATA.PS.txt +
'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace
quit
/*
//ENVVAR DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```
**nota**
É altamente recomendável armazenar as credenciais de FTP em um arquivo NETRC e restringir o acesso somente a usuários autorizados.
## Referência de comando do cliente Putty SFTP (PSFTP)
O cliente PSFTP não suporta todos os comandos de FTP. A lista a seguir mostra todos os comandos que o PSFTP suporta.
| Command | Description |
| --- | --- |
| \$1 | Executar um comando local |
| tchau | Conclua sua sessão de SFTP |
| cd \$1 | Altere seu diretório de trabalho remoto |
| chmod | Alterar permissões e modos de arquivo |
| feche | Conclua sua sessão de SFTP, mas não saia do PSFTP |
| del | Excluir arquivos no servidor remoto |
| dir | Listar arquivos remotos |
| exit | Conclua sua sessão de SFTP |
| obter | Baixe um arquivo do servidor para sua máquina local |
| help | Dê ajuda |
| lcd | Alterar diretório de trabalho local |
| lpwd | Imprimir diretório de trabalho local |
| ls | Listar arquivos remotos |
| ímã | Baixe vários arquivos de uma só vez |
| mkdir | Crie diretórios no servidor remoto |
| entrada | Faça upload de vários arquivos de uma só vez |
| mv | Mover ou renomear arquivo (s) no servidor remoto |
| aberto | Conecte-se a um host |
| put | Upload um arquivo da sua máquina local para o servidor |
| PWD | Imprima seu diretório de trabalho remoto |
| sair | Conclua sua sessão de SFTP |
| arrepender | Continue baixando arquivos |
| arrancar | Mover ou renomear arquivo (s) no servidor remoto |
| reputação | Continuar carregando arquivos |
| /rm | Excluir arquivos no servidor remoto |
| rmdir | Remover diretórios no servidor remoto |
## Próximas etapas
Para carregar e baixar arquivos no Amazon Simple Storage Service usando SFTP, você pode usar o M2SFTP em conjunto com o AWS Transfer Family, conforme descrito nas postagens do blog a seguir.
+ [Usando diretórios lógicos AWS SFTP para criar um serviço simples de distribuição de dados](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Ativar a autenticação por senha para AWS Transfer for SFTP usar AWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)
# Utilitário em lote M2WAIT
O M2WAIT é um programa utilitário de mainframe que permite introduzir um período de espera em seus scripts JCL especificando uma duração de tempo em segundos, minutos ou horas. Você pode chamar o M2WAIT diretamente do JCL passando o tempo que deseja esperar como parâmetro de entrada. Internamente, o programa M2WAIT chama o módulo fornecido pela Rocket Software (anteriormente Micro Focus) `C$SLEEP` para aguardar um tempo especificado.
**nota**
Você pode usar aliases da Micro Focus para substituir o que você tem em seus scripts JCL. Para obter mais informações, consulte [JES Alias](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html) na documentação da Micro Focus.
**Topics**
+ [Plataformas compatíveis](#m2wait-platforms)
+ [Configurar o M2WAIT para a modernização gerenciada do AWS mainframe](#m2wait-configure-managed)
+ [Configure o M2WAIT para o tempo de AWS execução da modernização do mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces](#m2wait-configure-customer-infra)
+ [Amostra de JCL](#m2wait-jcl)
## Plataformas compatíveis
Você pode usar o M2WAIT em qualquer uma das seguintes plataformas:
+ AWS Software de modernização de mainframe Rocket (anteriormente Micro Focus) gerenciado
+ Rocket Software Runtime (no Amazon EC2)
+ Todas as variantes dos produtos Rocket Software Enterprise Developer (ED) e Rocket Software Enterprise Server (ES).
## Configurar o M2WAIT para a modernização gerenciada do AWS mainframe
Se seus aplicativos migrados estiverem sendo executados no AWS Mainframe Modernization Managed, você precisará configurar o M2WAIT da seguinte forma.
+ Use o programa M2WAIT em seu JCL passando o parâmetro de entrada conforme mostrado em. [Amostra de JCL](#m2wait-jcl)
## Configure o M2WAIT para o tempo de AWS execução da modernização do mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces
Se seus aplicativos migrados estiverem sendo executados em tempo de execução de modernização de AWS mainframe no Amazon EC2, configure o M2WAIT da seguinte forma.
1. Altere o [caminho do programa Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir a localização binária dos utilitários em lote. Se você precisar especificar vários caminhos, use dois pontos (`:`) para separar caminhos no Linux e ponto e vírgula (`;`) no Windows.
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. Use o programa M2WAIT em seu JCL passando o parâmetro de entrada conforme mostrado em. [Amostra de JCL](#m2wait-jcl)
## Amostra de JCL
Para testar a instalação, você pode usar o `M2WAIT1.jcl` programa.
Este exemplo de JCL mostra como chamar o M2WAIT e passá-lo por várias durações diferentes.
```
//M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Wait for 12 Seconds*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2WAIT,PARM='S012'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 0 Seconds (defaulted to 10 Seconds)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=M2WAIT,PARM='S000'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 1 Minute*
//*-------------------------------------------------------------------**
//*
//STEP03 EXEC PGM=M2WAIT,PARM='M001'
//SYSOUT DD SYSOUT=*
//*
//
```
# TXT2Utilitário de lote de
TXT2PDF é um programa utilitário de mainframe comumente usado para converter um arquivo de texto em um arquivo PDF. Este utilitário usa o mesmo código-fonte para TXT2 PDF (z/OSfreeware). Nós o modificamos para ser executado no ambiente de execução do AWS Mainframe Modernization Rocket Software (antigo Micro Focus).
**Topics**
+ [Plataformas compatíveis](#txt2pdf-platforms)
+ [Configurar o TXT2 PDF para a modernização AWS gerenciada do mainframe](#txt2pdf-configure-managed)
+ [Configure o TXT2 PDF para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces](#txt2pdf-configure-customer-infra)
+ [Amostra de JCL](#txt2pdf-jcl)
+ [Modificações](#txt2pdf-mods)
+ [Referências](#txt2pdf-ref)
## Plataformas compatíveis
Você pode usar o TXT2 PDF em qualquer uma das seguintes plataformas:
+ AWS Modernização de mainframe \$1 Rocket \$1 Software gerenciado
+ Rocket Software Runtime (no Amazon EC2)
+ Todas as variantes dos produtos Rocket Enterprise Developer (ED) e Rocket Enterprise Server (ES).
## Configurar o TXT2 PDF para a modernização AWS gerenciada do mainframe
Se seus aplicativos migrados estiverem sendo executados no AWS Mainframe Modernization Managed, configure o TXT2 PDF da seguinte forma.
+ Crie uma biblioteca REXX EXEC chamada `AWS.M2.REXX.EXEC`. Baixe esses [módulos REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) e copie-os para a biblioteca.
+ `TXT2PDF.rex`- z/OS Software gratuito TXT2 em PDF (modificado)
+ `TXT2PDFD.rex`- z/OS Software gratuito TXT2 em PDF (não modificado)
+ `TXT2PDFX.rex`- z/OS Software gratuito TXT2 em PDF (modificado)
+ `M2GETOS.rex`: para verificar o tipo de sistema operacional (Windows ou Linux)
Para testar sua configuração, consulte [Amostra de JCL](#txt2pdf-jcl).
## Configure o TXT2 PDF para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces
Se seus aplicativos migrados estiverem sendo executados em tempo de execução de modernização de AWS mainframe no Amazon EC2, configure o PDF da seguinte forma. TXT2
1. Defina a variável de ambiente Rocket Software `MFREXX_CHARSET` com o valor apropriado, como “`A`" para dados ASCII.
**Importante**
Inserir o valor errado pode causar problemas de conversão de dados (de EBCDIC para ASCII), tornando o PDF resultante ilegível ou inoperável. Recomendamos que `MFREXX_CHARSET` a configuração corresponda`MF_CHARSET`.
1. Altere o [caminho do programa Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir a localização binária dos utilitários em lote. Se você precisar especificar vários caminhos, use dois pontos (`:`) para separar caminhos no Linux e ponto e vírgula (`;`) no Windows.
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. Crie uma biblioteca REXX EXEC chamada `AWS.M2.REXX.EXEC``. Baixe esses [módulos REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) e copie-os para a biblioteca.
+ `TXT2PDF.rex`- z/OS Software gratuito TXT2 em PDF (modificado)
+ `TXT2PDFD.rex`- z/OS Software gratuito TXT2 em PDF (não modificado)
+ `TXT2PDFX.rex`- z/OS Software gratuito TXT2 em PDF (modificado)
+ `M2GETOS.rex`: para verificar o tipo de sistema operacional (Windows ou Linux)
Para testar sua configuração, consulte [Amostra de JCL](#txt2pdf-jcl).
## Amostra de JCL
Para testar a instalação, você pode usar um dos seguintes arquivos JCL de exemplo.
**TXT2PDF1.jcl**
Esse arquivo JCL de amostra usa um nome DD para a conversão de TXT2 PDF.
```
//TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL EXEC PGM=IEFBR14
//*
//DD01 DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
// DISP=(MOD,DELETE,DELETE)
//*
//DD02 DD DSN=AWS.M2.TXT2PDF1.PDF,
// DISP=(MOD,DELETE,DELETE)
//*
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE 6TH LINE ON THE PAGE 1
THIS IS THE 7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE 6TH LINE ON THE PAGE 2
THIS IS THE 7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE
/*
//*
//OUTDD DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD DDNAME=SYSIN
//*
//SYSIN DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT DD:OUTDD +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR
//*
//OUTFILE DD DSN=AWS.M2.TXT2PDF1.PDF,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT DD SYSOUT=*
//*
//
```
**TXT2PDF2.jcl**
Esse exemplo de JCL usa um nome DSN para a TXT2 conversão de PDF.
```
//TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL EXEC PGM=IEFBR14
//*
//DD01 DD DSN=AWS.M2.TXT2PDF2.PDF.VB,
// DISP=(MOD,DELETE,DELETE)
//*
//DD02 DD DSN=AWS.M2.TXT2PDF2.PDF,
// DISP=(MOD,DELETE,DELETE)
//*
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE 6TH LINE ON THE PAGE 1
THIS IS THE 7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE 6TH LINE ON THE PAGE 2
THIS IS THE 7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE
/*
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD DDNAME=SYSIN
//*
//SYSIN DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT 'AWS.M2.TXT2PDF2.PDF.VB' +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR
//*
//OUTFILE DD DSN=AWS.M2.TXT2PDF2.PDF,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT DD SYSOUT=*
//*
//
```
## Modificações
Para que o programa TXT2 PDF seja executado no ambiente de execução do AWS Mainframe Modernization Rocket Software, fizemos as seguintes alterações:
+ Alterações no código-fonte para garantir a compatibilidade com o tempo de execução do Rocket Software REXX
+ Alterações para garantir que o programa possa ser executado nos sistemas operacionais Windows e Linux
+ Modificações para suportar o runtime EBCDIC e ASCII
## Referências
TXT2Referências em PDF e código-fonte:
+ [Conversor de texto para PDF](https://homerow.net/rexx/txt2pdf/)
+ [z/OSFerramentas gratuitas TCP/IP e de correio](http://www.lbdsoftware.com/tcpip.html)
+ [TXT2Guia de referência do usuário em PDF](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf)
# Utilitário em lote M2DFUTIL
O M2DFUTIL é um programa utilitário em JCL que fornece funções de backup, restauração, exclusão e cópia em conjuntos de dados, semelhantes ao suporte fornecido pelo utilitário ADRDSSU de mainframe. Esse programa retém muitos dos parâmetros SYSIN do ADRDSSU, o que simplifica o processo de migração para esse novo utilitário.
**Topics**
+ [Plataformas compatíveis](#m2dfutil-platforms)
+ [Requisitos da plataforma](#m2dfutil-platform)
+ [Suporte futuro planejado](#m2udfutil-future-support)
+ [Locais dos ativos](#mdfutil-assets)
+ [Configure o tempo de execução do M2DFUTIL ou da modernização do AWS mainframe no Amazon EC2 (incluindo 2.0) AppStream](#mdfutil-dependencies)
+ [Sintaxe geral](#mdfutil-syntax)
+ [Amostra JCLs](#mdfutil-sample-jcls)
## Plataformas compatíveis
Você pode usar o M2DFUTIL em qualquer uma das seguintes plataformas:
+ Rocket Software (anteriormente Micro Focus) ES no Windows (64 bits e 32 bits)
+ Rocket Software ES em Linux (64 bits)
## Requisitos da plataforma
O M2DFUTIL depende da chamada de um script para realizar um teste de expressão regular. No Windows, você deve instalar o Windows Services for Linux (WSL) para que esse script seja executado.
## Suporte futuro planejado
Os recursos que atualmente não estão disponíveis no utilitário ADRDSSU de mainframe, mas que estão no escopo futuro, incluem:
+ M2 gerenciado
+ VSAM
+ Suporte a COPY para a renomeação de nomes de arquivos
+ Suporte a RENAME para RESTORE
+ INCLUDE e EXCLUDE vários
+ Cláusula BY para subseleção por DSORG, CREDT, EXPDT
+ Cláusula MWAIT para tentar novamente falhas de enfileiramento
+ Suporte ao armazenamento do S3 para DUMP/RESTORE
## Locais dos ativos
O módulo de carregamento desse utilitário é chamado `M2DFUTIL.so` no Linux e `M2DFUTIL.dll` no Windows. Esse módulo de carregamento pode ser encontrado em um dos seguintes locais:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit`
O script usado para testes de expressão regular é chamado `compare.sh`. O script pode ser encontrado em um dos seguintes locais:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\scripts`
## Configure o tempo de execução do M2DFUTIL ou da modernização do AWS mainframe no Amazon EC2 (incluindo 2.0) AppStream
Configure sua região do Enterprise Server com o seguinte:
+ Adicione as seguintes variáveis em **[ES-Environment]**:
+ `M2DFUTILS_BASE_LOC`: o local padrão para a saída DUMP
+ `M2DFUTILS_SCRIPTPATH`: o local do script `compare.sh` documentado em **Locais dos ativos**
+ `M2DFUTILS_VERBOSE`: [VERBOSO ou NORMAL]. Isso controla o nível de detalhe na saída `SYSPRINT `
+ Verificar se o caminho do módulo de carregamento foi adicionado à configuração `JES\Configuration\JES Program Path`
+ Verifique se os scripts no diretório de utilitários têm permissões de execução. É possível adicionar uma permissão de execução usando o comando `chmod + x