

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á.

# Tutorial: Configurar o tempo de execução gerenciado para o Rocket Software (antigo Micro Focus)
<a name="tutorial-runtime-mf"></a>

Você pode implantar e executar um aplicativo no ambiente de tempo de execução gerenciado da modernização de AWS mainframe com o mecanismo de tempo de execução da Rocket Software. Este tutorial mostra como implantar e executar o aplicativo de CardDemo amostra em um ambiente de tempo de execução gerenciado de modernização de AWS mainframe com o mecanismo de tempo de execução da Rocket Software. O aplicativo CardDemo de amostra é um aplicativo simplificado de cartão de crédito desenvolvido para testar e mostrar a tecnologia de uma parceria para casos AWS de uso de modernização de mainframe.

No tutorial, você cria recursos em outros Serviços da AWS. Isso inclui o Amazon Simple Storage Service, o Amazon Relational Database Service AWS Key Management Service, AWS Secrets Manager e.

**Topics**
+ [Pré-requisitos](#tutorial-runtime-mf-prerequisites)
+ [Etapa 1: Criar e carregar um bucket do Amazon S3](#tutorial-runtime-mf-s3)
+ [Etapa 2: Criar e configurar um banco de dados](#tutorial-runtime-mf-db)
+ [Etapa 3: criar e configurar um AWS KMS key](#tutorial-runtime-mf-kms)
+ [Etapa 4: criar e configurar um segredo de AWS Secrets Manager banco de dados](#tutorial-runtime-mf-secret)
+ [Etapa 5: adicionar o SSLMode ao segredo](#tutorial-runtime-mf-ssl-mode)
+ [Etapa 6: criar um ambiente de tempo de execução](#tutorial-runtime-mf-env)
+ [Etapa 7: criar um aplicativo](#tutorial-runtime-mf-app)
+ [Etapa 8: implantar um aplicativo](#tutorial-runtime-mf-deploy)
+ [Etapa 9: importar conjuntos de dados](#tutorial-runtime-mf-import)
+ [Etapa 10: iniciar um aplicativo](#tutorial-runtime-mf-start)
+ [Etapa 11: Conecte-se ao aplicativo CardDemo CICS](#tutorial-runtime-mf-connect)
+ [Limpar os recursos](#tutorial-runtime-mf-clean)
+ [Próximas etapas](#tutorial-runtime-mf-next)

## Pré-requisitos
<a name="tutorial-runtime-mf-prerequisites"></a>
+ Verifique se você tem acesso a um emulador 3270 para usar a conexão CICS. Os emuladores 3270 gratuitos e de teste estão disponíveis em sites de terceiros. Como alternativa, você pode iniciar uma instância do AWS Mainframe Modernization WorkSpaces Applications Rocket Software e usar o emulador Rumba 3270 (não disponível gratuitamente).

  Para obter informações sobre WorkSpaces aplicativos, consulte[Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md).
**nota**  
Ao criar a pilha, escolha a opção Enterprise Developer (ED) e não o Enterprise Analyzer (EA).
+ Baixe o [aplicativo CardDemo de amostra](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/mf/CardDemo_runtime.zip) e descompacte o arquivo baixado em qualquer diretório local. Esse diretório conterá um subdiretório intitulado `CardDemo_runtime`.
+ Identifique uma VPC na conta na qual você possa definir os recursos criados neste tutorial. A VPC precisará de sub-redes em, pelo menos, duas Zonas de Disponibilidade. Para ter mais informações sobre a Amazon VPC, consulte [Como funciona a Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/how-it-works.html).

## Etapa 1: Criar e carregar um bucket do Amazon S3
<a name="tutorial-runtime-mf-s3"></a>

Nesta etapa, você cria um bucket do Amazon S3 e carrega CardDemo arquivos para esse bucket. Posteriormente neste tutorial, você usará esses arquivos para implantar e executar o aplicativo de CardDemo amostra em um ambiente de tempo de execução gerenciado do AWS Mainframe Modernization Rocket Software.

**nota**  
Não é necessário criar um bucket do S3, mas o bucket escolhido deve estar na mesma região que outros recursos usados neste tutorial.

**Como criar um bucket do Amazon S3**

1. Abra o [Console do Amazon S3](https://s3.console.aws.amazon.com/s3/home) e escolha **Criar bucket**.

1. Em **Configuração geral**, escolha a **região da AWS** em que você deseja criar o AWS Mainframe Modernization Rocket Software Managed Runtime.

1. Insira o **Nome do bucket**, por exemplo, `yourname-aws-region-carddemo`. Mantenha as configurações padrão e escolha **Criar bucket**. Como alternativa, você também pode copiar as configurações de um bucket do Amazon S3 existente e, depois, escolher **Criar bucket**.

1. Escolha o bucket que você acabou de criar e, depois, escolha **Fazer Upload**.

1. Na seção **Fazer upload**, escolha **Adicionar pasta** e, depois, acesse o diretório `CardDemo_runtime` no computador local.

1. Escolha **Fazer upload **para iniciar o processo de upload. Os tempos de upload variam de acordo com a velocidade de conexão.

1. Quando o upload for concluído, confirme se todos os arquivos foram carregados com êxito e escolha **Fechar**.

O bucket do Amazon S3 agora contém a pasta `CardDemo_runtime`.

![\[A guia CardDemo Objetos mostrando a pasta do CardDemo aplicativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-carddemo-s3.png)


Para ter mais informações sobre os buckets do S3, consulte [Criar, configurar e trabalhar com buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html).

## Etapa 2: Criar e configurar um banco de dados
<a name="tutorial-runtime-mf-db"></a>

Nesta etapa, você vai criar um banco de dados PostgreSQL no Amazon Relational Database Service (Amazon RDS). Para o tutorial, esse banco de dados contém os conjuntos de dados que o aplicativo de CardDemo amostra usa para tarefas do cliente relacionadas a transações com cartão de crédito.

**Para criar um banco de dados no Amazon RDS**

1. Abra o [console do Amazon RDS](https://console.aws.amazon.com/rds/).

1. Escolha a região da AWS na qual você deseja criar a instância de banco de dados.

1. Escolha **Databases** (Bancos de dados) no painel de navegação. 

1. Escolha **Criar banco de dados** e **Criação padrão**.

1. Em **Tipo de mecanismo**, escolha **PostgreSQL**.

1. Escolha a **versão do mecanismo** 15 ou posterior.
**nota**  
Salve a versão do mecanismo porque você precisará dela posteriormente neste tutorial.

1. Na seção **Modelos**, escolha **Nível gratuito**.

1. Altere o **identificador da instância de banco de dados** para algo significativo, por exemplo, `MicroFocus-Tutorial`.

1. Evite gerenciar credenciais principais no AWS Secrets Manager. Insira uma senha *principal* e confirme-a.
**nota**  
Salve o nome de usuário e a senha utilizados para o banco de dados. Você os armazenará com segurança nas próximas etapas deste tutorial.

1. Em **Conectividade**, escolha a **VPC** em que você deseja criar o ambiente de tempo de execução gerenciado da modernização do AWS mainframe.

1. Selecione **Criar banco de dados**.

**Como criar um grupo de parâmetros personalizado no Amazon RDS**

1. No painel de navegação do console do Amazon RDS, selecione **Grupos de parâmetros** e, depois, **Criar grupo de parâmetros**.

1. Na janela **Criar grupo de parâmetros**, em **Família de grupos de parâmetros**, selecione a opção **Postgres** correspondente à versão do banco de dados.
**nota**  
Algumas versões do Postgres exigem um **Tipo**. Selecione **Grupo de parâmetros de banco de dados**, se necessário. Insira um **Nome do grupo** e **Descrição** para o grupo de parâmetros.

1. Escolha **Criar**.

**Como configurar o grupo de parâmetros personalizado**

1. Escolha o grupo de parâmetros recém-criado.

1. Escolha **Ações** e, em seguida, escolha **Editar**.

1. Filtre `max_prepared_transactions` e altere o valor de parâmetro para 100.

1. Escolha **Salvar alterações**.

**Como associar o grupo de parâmetros personalizado ao banco de dados**

1. No painel de navegação do console do Amazon RDS, escolha **Bancos de dados** e a instância de banco de dados a ser modificada.

1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida. 
**nota**  
A opção **Modificar** não estará disponível até que o banco de dados termine de criar e fazer backup, o que pode levar alguns minutos.

1. Na página **Modificar instância de banco de dados**, acesse **Configuração adicional** e altere o **grupo de parâmetros do banco de dados** para o grupo de parâmetros. Se o grupo de parâmetros não estiver disponível na lista, confira se ele foi criado com a versão correta do banco de dados.

1. Escolha **Continuar** e confira o resumo de modificações.

1. Escolha **Aplicar imediatamente** para aplicar as alterações imediatamente.

1. Selecione **Modificar instância de banco de dados** para salvar as alterações.

Para obter mais informações sobre grupos de parâmetros, consulte [Trabalho com grupos de parâmetros](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html).

**nota**  
Você também pode usar um banco de dados Amazon Aurora PostgreSQL com a modernização do AWS mainframe, mas não há opção de nível gratuito. Para ter mais informações, consulte [Trabalho com Amazon Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html).

## Etapa 3: criar e configurar um AWS KMS key
<a name="tutorial-runtime-mf-kms"></a>

Para armazenar credenciais com segurança para a instância do Amazon RDS, primeiro crie uma AWS KMS key.

**Para criar um AWS KMS key**

1. Abra o [Console do Key Management Service](https://console.aws.amazon.com/kms/home).

1. Escolha **Create Key (Criar chave)**.

1. Deixe os padrões de **Simétrico** para o tipo de chave e **Criptografar e descriptografar** para o uso da chave.

1. Escolha **Próximo**.

1. Atribua à chave um **Alias**, como `MicroFocus-Tutorial-RDS-Key` e uma descrição opcional.

1. Escolha **Próximo**.

1. Atribua um administrador de chaves marcando a caixa ao lado do seu usuário ou função.

1. Escolha **Próximo**. 

1. Atribua permissão de uso da chave marcando a caixa ao lado do seu usuário ou função.

1. Escolha **Próximo**.

1. Na tela de revisão, edite a **política de chave** e insira o seguinte **na matriz “Declaração” existente**:

   ```
   {
        "Sid" : "Allow access for Mainframe Modernization Service",
        "Effect" : "Allow",
           "Principal" : {
              "Service" : "m2.amazonaws.com"
                    },
         "Action" : "kms:Decrypt",
         "Resource" : "*"
   },
   ```

   Essa política concede permissões de decodificação da Modernização do AWS Mainframe usando essa política de chaves específica.

1. Escolha **Concluir** para criar a chave.

Para obter mais informações, consulte [Criação de chaves](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) no Guia do AWS Key Management Service desenvolvedor.

## Etapa 4: criar e configurar um segredo de AWS Secrets Manager banco de dados
<a name="tutorial-runtime-mf-secret"></a>

Agora armazene as credenciais do banco de dados com segurança usando e. AWS Secrets Manager AWS KMS key

**Para criar e configurar um segredo de AWS Secrets Manager banco de dados**

1. Abra o [console do Secrets Manager](https://console.aws.amazon.com/secretsmanager/).

1. No painel de navegação, escolha **Secrets** (Segredos).

1. Em **Segredos**, escolha **Armazenar um novo segredo**.

1. Em **Tipo de segredo**, escolha **Credenciais para um banco de dados do Amazon RDS**.

1. Insira as **credenciais** que você especificou ao criar o banco de dados. 

1. Em **Chave de criptografia**, selecione a chave que você criou na etapa 3.

1. Na seção **Banco de dados**, selecione o banco de dados que você criou para este tutorial e escolha **Próximo**.

1. Em **Nome do segredo**, insira um nome, como `MicroFocus-Tutorial-RDS-Secret`, e uma descrição opcional.

1. Na seção **Permissões de recursos**, escolha **Editar permissões** e substitua o conteúdo pela seguinte política:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect" : "Allow",
               "Principal" : {
                   "Service" : "m2.amazonaws.com"
               },
               "Action" : "secretsmanager:GetSecretValue",
               "Resource" : "*"
           }
       ]
   }
   ```

------

1. Escolha **Salvar**.

1. Escolha **Próximo** para as telas subsequentes e, depois, escolha **Armazenar**. 

## Etapa 5: adicionar o SSLMode ao segredo
<a name="tutorial-runtime-mf-ssl-mode"></a>

**Para adicionar o SSLMode ao segredo**

1. Atualize a lista de segredos para ver o novo segredo.

1. Escolha o segredo recém-criado na etapa 4 e anote o `Secret ARN` porque você precisará dele posteriormente no tutorial.

1. Na guia **Visão geral** do segredo, escolha **Recuperar o valor do segredo**.

1. Escolha **Editar** e **Adicionar linha**.

1. Adicione uma **chave** para `sslMode` com um **valor** de `verify-full`:  
![\[Insira o key/value par para obter o Secrets Manager Secret.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-carddemo-secret.png)

1. Escolha **Salvar**.

## Etapa 6: criar um ambiente de tempo de execução
<a name="tutorial-runtime-mf-env"></a>

**Para criar um ambiente de runtime**

1. Abra o [console do AWS Mainframe Modernization](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing).

1. No painel de navegação, escolha **Ambientes**. Depois, escolha **Criar ambiente.**  
![\[A página Criar ambiente na guia Ambientes.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-environment.png)

1. Em **Especificar informações básicas**,

   1. Insira `MicroFocus-Environment` para o nome do ambiente.

   1. Nas opções do motor, verifique se a opção **Micro Focus (Rocket)** está selecionada.

   1. Escolha a versão mais recente do **Micro Focus (Rocket)**. 

   1. Escolha **Próximo**.  
![\[Seção de nome, descrição e versão do ambiente de tempo de execução.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-create-env-basic.png)

1. Configure o ambiente.

   1. Em **Disponibilidade**, escolha **Cluster de alta disponibilidade**.

   1. Em **Recursos**, escolha **M2.c5.large** ou **M2.m5.large** para o tipo de instância, bem como o número de instâncias desejado. Especifique até duas instâncias.

   1. Em **Segurança e rede**, escolha **Permitir que as aplicações implantadas nesse ambiente sejam acessíveis ao público** e escolha, pelo menos, duas sub-redes públicas. 

   1. Escolha **Próximo**.  
![\[A página Especificar configurações com um cluster de alta disponibilidade e um tipo de instância específico selecionados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/env-config.png)

1. Na página **Anexar armazenamento**, escolha **Próximo**.

1. Na página **Programar manutenção**, escolha **Sem preferência** e, depois, escolha **Próximo**.  
![\[O cronograma de manutenção para o ambiente.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-env-maintenance.png)

1. Na página **Revisar e criar**, revise todas as configurações que você forneceu para o ambiente de tempo de execução e escolha **Criar ambiente**.  
![\[A página Revisar e criar com as seleções anteriores.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-env-review.png)

Quando você cria seu ambiente, aparece um banner que diz `Environment name was created successfully`, e o campo **Status** muda para **Disponível**. O processo de criação do ambiente leva alguns minutos, mas você pode prosseguir para as próximas etapas enquanto ele é executado.

![\[A mensagem do ambiente foi criada com sucesso.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-env-confirm.png)


## Etapa 7: criar um aplicativo
<a name="tutorial-runtime-mf-app"></a>

**Como criar uma aplicação do**

1. No painel de navegação, escolha **Aplicativos**. Escolha **Criar aplicação**.  
![\[A página Aplicações com o botão Criar aplicação é exibida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/app-create.png)

1. Na página **Criar aplicativo**, em **Especificar informações básicas**, insira `MicroFocus-CardDemo` o nome do aplicativo e, em **Tipo de mecanismo, certifique-se de** que **Micro Focus (Rocket)** esteja selecionado. Escolha **Próximo**.  
![\[A página Criar aplicativos com o tipo de mecanismo da Rocket Software selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-create-app.png)

1. Em **Especificar recursos e configurações**, escolha a opção para especificar a definição da aplicação com os recursos e as configurações usando o editor em linha.  
![\[A página Especificar recursos e configurações com um arquivo JSON exibido no editor on-line.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-config.png)

   Insira a seguinte definição de aplicação no editor:

   ```
   {
     "template-version": "2.0",
     "source-locations": [
       {
         "source-id": "s3-source",
         "source-type": "s3",
         "properties": {
           "s3-bucket": "yourname-aws-region-carddemo",
           "s3-key-prefix": "CardDemo_runtime"
         }
       }
     ],
     "definition": {
       "listeners": [
         {
           "port": 6000,
           "type": "tn3270"
         }
       ],
       "dataset-location": {
         "db-locations": [
           {
             "name": "Database1",
             "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx"
           }
         ]
       },
       "batch-settings": {
         "initiators": [
           {
             "classes": [
                  "A",
                  "B"
               ],
             "description": "initiator_AB...."
           },
           {
             "classes": [
                   "C",
                   "D"
                ],
             "description": "initiator_CD...."
           }
         ],
         "jcl-file-location": "${s3-source}/catalog/jcl"
       },
       "cics-settings": {
         "binary-file-location": "${s3-source}/loadlib",
         "csd-file-location": "${s3-source}/rdef",
         "system-initialization-table": "CARDSIT"
       },
       "xa-resources": [
         {
           "name": "XASQL",
           "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx",
           "module": "${s3-source}/xa/ESPGSQLXA64.so"
         }
       ]
     }
   }
   ```
**nota**  
Esse arquivo está sujeito a alterações.

1. Edite a aplicação JSON no objeto **propriedades** dos **locais de origem** da seguinte maneira:

   1. Substitua o valor de `s3_bucket` pelo nome do bucket do Amazon S3 criado na Etapa 1.

   1. Substitua o valor `s3-key-prefix` de pela pasta (prefixo de chave) na qual você fez o upload dos arquivos de CardDemo amostra. Se você fez upload do diretório `CardDemo` diretamente em um bucket do Amazon S3, o `s3-key-prefix` não precisará ser alterado.

   1. Substitua os dois valores `secret-manager-arn` pelo ARN do segredo do banco de dados que você criou na Etapa 4.  
![\[Definição da aplicação JSON.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-resources.png)

   Para obter mais informações sobre a definição da aplicação, consulte [Definição do aplicativo Rocket Software (anteriormente Micro Focus)](applications-m2-definition.md#applications-m2-definition-mf).

1. Escolha **Próximo** para continuar.

1. Na página **Revisar e criar**, analise as informações fornecidas e escolha **Criar aplicação**.

![\[A mensagem da aplicação foi criada com sucesso.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-confirm.png)


Ao criar-se a aplicação, é exibido um banner que diz `Application name was created successfully`. E o campo **Status** muda para **Disponível**.

## Etapa 8: implantar um aplicativo
<a name="tutorial-runtime-mf-deploy"></a>

**Para implantar uma aplicação**

1. No painel de navegação, escolha **Aplicações** e, depois, `MicroFocus-CardDemo`.

1. Em **Implantar aplicação**, escolha **Implantar**.  
![\[A MicroFocus - implantação CardDemo do aplicativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-deploy.png)

1. Escolha a versão mais recente da aplicação e o ambiente do que você criou anteriormente e escolha **Implantar**.  
![\[A página Implantar a aplicação e o ambiente.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-env-deploy.png)

Quando o CardDemo aplicativo é implantado com êxito, o status muda para **Pronto**.

![\[A página de confirmação Aplicação implantada no ambiente.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-env-confirm.png)


## Etapa 9: importar conjuntos de dados
<a name="tutorial-runtime-mf-import"></a>

**Como importar conjuntos de dados**

1. No painel de navegação, escolha **Aplicações** e, depois, escolha a aplicação. 

1. Escolha a guia **Conjuntos de dados**. Selecione **Import (Importar)**.

1. Escolha **Importar e editar configuração JSON** e, depois, escolha a opção **Copiar e colar o próprio JSON**.  
![\[Importe o conjunto de dados copiando o próprio script JSON.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-import.png)

1. Copie e cole o JSON a seguir, mas não escolha “Enviar” ainda. Esse JSON contém todos os conjuntos de dados necessários para a aplicação de demonstração, mas precisa dos detalhes do bucket do Amazon S3.

   ```
   {
       "dataSets": [
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 11,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 300,
                       "max": 300
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.AIX.PATH",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 11,
                               "offset": 16
                           }
                       }
                   },
                   "recordLength": {
                       "min": 150,
                       "max": 150
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 16,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 150,
                       "max": 150
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 16,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 50,
                       "max": 50
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 9,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 500,
                       "max": 500
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.AIX.PATH",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 11,
                               "offset": 25
                           }
                       }
                   },
                   "recordLength": {
                       "min": 50,
                       "max": 50
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 16,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 350,
                       "max": 350
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT"
               }
           },
           {
               "dataSet": {
                   "storageType": "Database",
                   "datasetName": "AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS",
                   "relativePath": "DATA",
                   "datasetOrg": {
                       "vsam": {
                           "format": "KS",
                           "encoding": "A",
                           "primaryKey": {
                               "length": 8,
                               "offset": 0
                           }
                       }
                   },
                   "recordLength": {
                       "min": 80,
                       "max": 80
                   }
               },
               "externalLocation": {
                   "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS.DAT"
               }
           }
       ]
   }
   ```

1. Substitua cada ocorrência de `<s3-bucket-name>` (há oito) pelo nome do bucket do Amazon S3 que contém a CardDemo pasta, por exemplo,. `your-name-aws-region-carddemo`
**nota**  
Para copiar o URI do Amazon S3 na pasta no Amazon S3, selecione a pasta e escolha **Copiar URI do Amazon S3**. 

1. Selecione **Enviar**.

   Quando a importação é concluída, um banner é exibido com a seguinte mensagem: `Import task with resource identifier name was completed successfully.` Uma lista dos conjuntos de dados importados é exibida.  
![\[Importação bem-sucedida do conjunto de dados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-import-success.png)

Também é possível visualizar o status de todas as importações de conjuntos de dados escolhendo **Histórico de importação** na guia **Conjuntos de dados**.

## Etapa 10: iniciar um aplicativo
<a name="tutorial-runtime-mf-start"></a>

**Com o iniciar uma aplicação**

1. No painel de navegação, escolha **Aplicações** e, depois, escolha a aplicação. 

1. Escolha **Iniciar aplicação**.  
![\[A página CardDemo do aplicativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-app-start.png)

Quando o CardDemo aplicativo começa a ser executado com sucesso, um banner aparece com a seguinte mensagem:`Application name was started successfully`. O campo **Status** muda para **Em execução**.

![\[A mensagem de início da aplicação foi bem-sucedida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-mf-startapp-confirm.png)


## Etapa 11: Conecte-se ao aplicativo CardDemo CICS
<a name="tutorial-runtime-mf-connect"></a>

Antes de se conectar, garanta que a VPC e o grupo de segurança especificados para a aplicação sejam os mesmos que você aplicou à interface de rede da qual você estabelecerá conexão.

Para configurar a TN3270 conexão, você também precisa do nome do host DNS e da porta do aplicativo.

**Como configurar e conectar uma aplicação ao mainframe usando o emulador de terminal**

1. Abra o console de modernização do AWS mainframe, escolha **Aplicativos** e, em seguida, escolha. `MicroFocus-CardDemo`

1. Escolha o ícone de cópia para copiar o **Nome do host do DNS**. Além disso, anote o número das **portas**.

1. Inicie um emulador de terminal. Este tutorial usa o Micro Focus Rumba\$1.
**nota**  
As etapas de configuração variam de acordo com o emulador.

1. Escolha **Exibição do mainframe**.  
![\[Tela de boas-vindas do Rumba+.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-mainframe.png)

1. Escolha **Conexão** e **Configurar.**  
![\[Tela de boas-vindas do Rumba+.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-configure.png)

1. Em **Interfaces instaladas**, escolha `TN3270` e `TN3270` novamente no menu **Conexão**.  
![\[Conecte-se às interfaces instaladas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-connection.png)

1. Escolha **Inserir** e cole o `DNS Hostname` para a aplicação. Especifique `6000` para a **porta Telnet**.  
![\[Especifique o nome do host e configure a porta.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-dns-hostname.png)
**nota**  
Se você estiver usando o AWS AppStream 2.0 em um navegador e tiver dificuldades em colar valores, consulte [Solução de problemas do usuário AppStream 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html#copy-paste-doesnt-work). 

1. Em **Conexão**, escolha **Avançado**, **Enviar Keep Alive** e **Enviar NOP** e insira **180** para o **Intervalo**.
**nota**  
Configurar a configuração keep alive em seu TN3270 terminal para pelo menos 180 segundos ajuda a garantir que o Network Load Balancer não interrompa sua conexão.  
![\[Tela Configuração avançada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-advanced.png)

1. Selecione **Conectar**.
**nota**  
Se a conexão falhar:   
Se você estiver usando AppStream 2.0, confirme se a VPC e o grupo de segurança especificados para o ambiente do aplicativo são os mesmos da frota 2.0. AppStream 
Use o VPC Reachability Analyzer para analisar a conexão. É possível acessar o Reachability Analyzer pelo [console](https://console.aws.amazon.com/networkinsights/home#ReachabilityAnalyzer). 
Como etapa de diagnóstico, tente adicionar ou alterar as regras de entrada do grupo de segurança da aplicação com o objetivo de permitir o tráfego para a porta 6000 de qualquer lugar (ou seja, Bloco CIDR 0.0.0.0/0). Se você se conectar com êxito, saberá que o grupo de segurança estava bloqueando o tráfego. Altere a origem do grupo de segurança para algo mais específico. Para ter mais informações sobre grupos de segurança, consulte [Noções básicas do grupo de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html#security-group-basics).

1. Digite `USER0001` para o nome de usuário e `password` para a senha.
**nota**  
No Rumba, o padrão para Limpar é ctrl-shift-z, e o padrão para Redefinir é ctrl-r.  
![\[Configure o nome de usuário e a senha para seu CardDemo aplicativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-username-password.png)

1. Depois de fazer login com sucesso, você pode navegar pelo CardDemo aplicativo.

1. Insira `01` para visualizar a conta.  
![\[Visualize sua CardDemo inscrição.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-carddemo.png)

1. Digite `00000000010` para o Número da conta e pressione **Enter** no teclado.
**nota**  
Outras contas válidas são `0000000011` e `00000000020`.  
![\[Gerencie seu CardDemo aplicativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/mf-cics-carddemo-account.png)

1. Pressione **F3** para sair do menu e **F3** para sair da transação.

## Limpar os recursos
<a name="tutorial-runtime-mf-clean"></a>

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:
+ Se necessário, interrompa a aplicação.
+ Exclua a aplicação do . Para obter mais informações, consulte [Excluir um AWS Mainframe Modernization aplicativo](applications-m2-delete.md).
+ Exclua o ambiente de runtime. Para obter mais informações, consulte [Excluir um ambiente de AWS execução de modernização de mainframeExcluir um ambiente de runtime](delete-environments-m2.md).
+ Exclua os buckets do Amazon 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 AWS Secrets Manager segredo que você criou para este tutorial. Para ter mais informações, consulte [Excluir um segredo](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_delete-secret.html).
+ Exclua a chave do KMS que você criou para este tutorial. Para ter mais informações, consulte [Deleting AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/deleting-keys.html).
+ Exclua o banco de dados do Amazon RDS que você criou para este tutorial. Para ter mais informações, consulte [Excluir a instância do EC2 e a instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL) no *Guia do usuário do Amazon RDS*.
+ Se você adicionou uma regra de grupo de segurança para a porta 6000, exclua-a.

## Próximas etapas
<a name="tutorial-runtime-mf-next"></a>

Para saber como configurar um ambiente de desenvolvimento para seus aplicativos modernizados, consulte o [Tutorial: Configuração AppStream 2.0 para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise](https://docs.aws.amazon.com/m2/latest/userguide/set-up-appstream-mf.html) Developer.