

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

# AWS Modernização do mainframe e reformulação da plataforma com a NTT DATA
<a name="unikix"></a>

AWS A modernização do mainframe oferece uma variedade de Amazon Machine Images (AMIs). Essas AMIs facilitam o rápido provisionamento de instâncias do Amazon EC2, criando um ambiente personalizado para rehospedar e reformular aplicativos de mainframe usando o NTT Data. AWS Este guia fornece as etapas necessárias para acessá-los e usá-los AMIs. 

## Pré-requisitos
<a name="prereqs-unikix"></a>
+ Certifique-se de ter acesso de administrador a uma AWS conta na qual você possa criar instâncias do Amazon EC2.
+ Verifique se o serviço de modernização do AWS mainframe está disponível na região em que você planeja criar as instâncias do Amazon EC2. Veja a [lista de serviços da AWS disponíveis por região](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
+ Identifique a Amazon VPC em que você deseja criar as instâncias do Amazon EC2.

## Inscrever-se para receber a imagem de máquina da Amazon
<a name="subscribe-to-images-unikix"></a>

Após a inscrição em um produto do AWS Marketplace, você pode executar uma instância usando a AMI do produto.

1. Faça login no Console de gerenciamento da AWS e abra o AWS Marketplace console em [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace).

1. Escolha **Manage subscriptions** (Gerenciar assinaturas).

1. Copie e cole o seguinte link na barra de endereço do navegador: [https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2)

1. Escolha **Continuar para assinar**.

1. Se os Termos e Condições forem aceitáveis, escolha **Aceitar Termos**. A assinatura pode levar alguns minutos para ser processada.

1. Aguarde até que uma mensagem de agradecimento seja exibida. Essa mensagem confirma que você se inscreveu com êxito no produto.

1. No painel de navegação esquerdo, escolha **Gerenciar assinaturas**. Essa visualização mostra todas as suas assinaturas.

## Inicie a replataforma de modernização de AWS mainframe com a instância NTT DATA
<a name="launch-data-replatform-unikix"></a>

1. Abra o AWS Marketplace console em [https://console.aws.amazon.com/marketplace.](https://console.aws.amazon.com/marketplace)

1. No painel de navegação esquerdo, escolha **Gerenciar assinaturas**.

1. Encontre a AMI que você deseja iniciar e escolha **Executar nova instância**.

1. Em **Região**, selecione a região listada como permitida.

1. Escolha **Continuar para executar por meio do EC2**. Essa ação direcionará você para o console do Amazon EC2.

1. Insira um nome para o servidor.

1. Selecione um tipo de instância que corresponda aos requisitos de desempenho e custo do seu projeto. O ponto de partida sugerido para o tamanho da instância é `c5.2xLarge`.

1. Escolha um par de chaves existente ou crie um e salve-o. Para ter informações sobre pares de chave, consulte [Pares de chaves do Amazon EC2 e instâncias do Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) no Manual do usuário do Amazon EC2.

1. Edite as configurações de rede e escolha a VPC na lista de permissões e a sub-rede apropriada.

1. Escolha um grupo de segurança existente ou crie um. Se for uma instância do Enterprise Server Amazon EC2, é comum permitir o tráfego TCP para as portas 86 e 10086 para administrar a configuração do Rocket Software (anteriormente Micro Focus).

1. Configure o armazenamento para a instância do Amazon EC2.

1. Revise o resumo e envie a **Executar instância**. Para que a execução tenha êxito, o tipo de instância deve ser válido. Se houver falha na execução, escolha **Editar configuração da instância** e escolha um tipo de instância diferente.

1. Depois de ver a mensagem de êxito, escolha **Conectar-se à Instância**.

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação esquerdo, no menu **Instâncias**, escolha **Instâncias**.

1. No painel principal, verifique o status da sua instância.

## Conceitos básicos da NTT Data
<a name="unikix-getting-started"></a>

Depois de provisionar a instância do Amazon EC2, faça o SSH nela com o nome de usuário `ec2-user`. A tela será exibida como a imagem a seguir.

![\[Tela SSH com a instância e o nome de usuário fornecidos do Amazon EC2.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-start-screen.png)


Abaixo da pasta `/opt/software/`, há uma pasta chamada `UniKix_Product_Guides`, conforme mostrado na imagem a seguir.

![\[Tela SSH com detalhes da pasta /opt/software/. Localize a pasta UniKix_Product_Guides.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-product-guides.png)


A pasta `UniKix_Product_Guides` inclui a documentação dos seguintes componentes que estão instalados nessa instância do Amazon EC2:
+ NTT DATA TPE
+ NTT DATA BPE
+ NTT DATA Enterprise COBOL
+ NTT DATA Secure UniKix 
+ Gerente UniKix central da NTT DATA

A pasta `software` que aparece na imagem anterior tem os binários dos componentes listados acima.

Depois de validar com sucesso a instância do Amazon EC2, comece a AWS usar a Mainframe Modernization Replatform com a NTT DATA seguindo a documentação da NTT Data.

# Tutorial: Implantar CardDemo aplicativo na NTT DATA
<a name="tutorial-unikix-runtime"></a>

Esta página orienta você pelo step-by-step processo de implantação do aplicativo de CardDemo amostra na replataforma de modernização de AWS mainframe com o tempo de execução do NTT DATA Unikix.

O aplicativo CardDemo de amostra é um aplicativo simplificado de mainframe projetado e desenvolvido para testar e mostrar a tecnologia de parceria para casos de uso de migração AWS e modernização de mainframe. 

Para obter mais informações sobre esse aplicativo, consulte [GitHubrepositório para CardDemo](https://github.com/aws-samples/aws-mainframe-modernization-carddemo).

**Topics**
+ [Diagrama do fluxo de implantação](#tutorial-unikix-workflow)
+ [Pré-requisitos](#tutorial-unikix-prerequisites)
+ [Etapa 1: preparar o ambiente](#tutorial-unikix-prepare)
+ [Etapa 2: criar uma região TPE](#tutorial-unikix-tpe)
+ [Etapa 3: criar o nó e o subsistema do BPE](#tutorial-unikix-bpe)
+ [Etapa 4: compilar e implantar CardDemo o aplicativo](#tutorial-unikix-compile)
+ [Etapa 5: importar o catálogo BPE e TPE](#tutorial-unikix-import)
+ [Etapa 6: iniciar e conectar o TPE ao BPE](#unikix-tutorial-connect)
+ [Etapa 7: executar o CardDemo aplicativo](#unikix-tutorial-run-application)
+ [Solução de problemas](#tutorial-unikix-troubleshoot)

## Diagrama do fluxo de implantação
<a name="tutorial-unikix-workflow"></a>

O diagrama a seguir mostra cada etapa do fluxo de trabalho para implantar uma aplicação no tempo de execução do NTT DATA Unikix.

![\[O fluxo de trabalho geral da implantação da aplicação no tempo de execução do NTT DATA Unikix.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-process.png)


## Pré-requisitos
<a name="tutorial-unikix-prerequisites"></a>
+ Siga as instruções fornecidas em [AWS Modernização do mainframe e reformulação da plataforma com a NTT DATA](unikix.md) Como usar a [AMI do NTT DATA UniKix Marketplace](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2).
+ Modifique a opção de metadados da instância **IMDSv2**para **Opcional**, conforme mencionado em [Restaurar o uso do IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) no guia do *usuário do Amazon EC2*.
+ Baixe os componentes CardDemo de tempo de execução para a NTT DATA UniKix a partir do 

  [GitHub repositório.](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip)
+ Faça login na instância EC2 em tempo de UniKix execução como`ec2-user`.
+ Extraia os componentes CardDemo de tempo de execução baixados usando este link: [UniKix\$1 CardDemo \$1runtime\$1v1.zip](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
  + O diretório extraído deve conter os diretórios `bin` e `migrated_app`.
  + Mova os diretórios `bin` e `migrated_app` para baixo do diretório `$HOME`. O caminho seria semelhante a `/home/ec2-user`.
  + É necessário ter os seguintes diretórios em `$HOME`:
    + `/home/ec2-user/bin`
    + `/home/ec2-user/migrated_app`
  + Mova todos os arquivos dentro do diretório \$1HOME/bin com o seguinte comando:
  + 
    + `chmod +x $HOME/bin/*`

## Etapa 1: preparar o ambiente
<a name="tutorial-unikix-prepare"></a>

Depois de concluir os pré-requisitos, a primeira etapa é preparar o ambiente em que você deseja implantar o aplicativo. CardDemo 

1. Faça login na instância EC2 em tempo de UniKix execução como`ec2-user`.

1. Observe a lista de UniKix softwares pré-embalados na AMI, como TPE, BPE e COBOL, junto com outros da localização do UniKix produto NTT DATA, usando o seguinte comando em sua instância do EC2:

   ```
   ls -l /opt/software/
   ```

1. Examine o CardDemo aplicativo migrado. Você verá todo o código-fonte, incluindo mapas BMS, programas COBOL, COBOL Copybooks e. JCLs Você também encontrará a exportação de catálogos BPE e TPE, definições de recursos do CICS e dados migrados, como arquivos sequenciais e arquivos VSAM, fazendo o seguinte:

   ```
   ls  $HOME/migrated_app/*/*
   ```

1. Crie uma estrutura de pastas executando o script `create_project` com o seguinte comando:

   ```
   sh $HOME/bin/create_project
   ```

1. Ative o CardDemo ambiente fornecendo o arquivo de `carddemo.env` configuração usando:

   ```
   source $HOME/bin/carddemo.env
   ```

## Etapa 2: criar uma região TPE
<a name="tutorial-unikix-tpe"></a>

Depois de ativar o ambiente em que você deseja implantar a aplicação, é necessário criar uma região TPE.

1. Crie uma região TPE usando o comando `kixregion createRegion` que requer entradas, como `$KIXSYS`, `$JAVA_HOME` e `$KIXLICDIR`. Essas variáveis de ambiente já estão configuradas no arquivo de configuração `carddemo.env`.

   ```
   kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
   ```

1. Configure a região TPE usando o comando `kixregion setAttr`.

   ```
   kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true
   kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol
   kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL
   kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps
   kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib
   kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA
   kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME
   kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS
   ```

1. Gere o arquivo de ambiente do usuário específico para essa região TPE executando o comando `kixregion createScript`. Esse comando cria ou atualiza `$KIXSYS/bin/userenv` com base na configuração da região TPE.

   ```
   kixregion createScript $KIXSYS
   ```

1. Ative a região TPE fornecendo o arquivo de ambiente do usuário (`$KIXSYS/bin/userenv`).

   ```
   source $KIXSYS/bin/userenv
   ```

1. Crie a região TPE executando o comando `kixinstall2`.

   ```
   kixinstall2
   ```

## Etapa 3: criar o nó e o subsistema do BPE
<a name="tutorial-unikix-bpe"></a>

Depois de criar uma região TPE, você precisa criar o nó e o subsistema BPE seguindo estas etapas.

1. Altere a propriedade e as permissões de `INSTEBM`.

   ```
   sudo chown root $INSTEBM 
   sudo chmod 4755 $INSTEBM
   ```

1. Crie um nó BPE usando o comando `INSTEBM`. O diretório do nó do BPE é fornecido como parâmetro de entrada.

   ```
   $INSTEBM $EBMHOME
   ```

1. Ative o ambiente em lote fornecendo o arquivo `batchenv` do nó do BPE recém-criado.

   ```
   source $EBMHOME/batchenv
   ```

1. Crie o subsistema BPE dentro desse nó utilizando o Batch Administration Manager (bam). O comando `bam` abrirá a interface do Batch Administration Manager.

   ```
   bam
   ```

   1. Inicie o nó do BPE usando a interface BAM. Escolha a opção 2, **Ambientes do sistema** no menu principal.  
![\[No Batch Administrator Manager, escolha a opção 2 Ambientes do sistema.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-1.png)

   1. Escolha a opção 2, **Iniciar/(Parar) Batch Node** para iniciar o nó do BPE.   
![\[Em Ambientes do sistema, escolha o nó de Start/Stop lote da opção 2.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-2.png)

   1. Depois de iniciado, pressione a **tecla Voltar** duas vezes para voltar ao menu principal do BAM.  
![\[Tela concluída de inicialização do Batch Node.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-3.png)

   1. Para criar o subsistema BPE, escolha a opção 3, **Aplicações e subsistemas**.  
![\[Opção 3 Aplicativos e subsistemas selecionada na página Batch Administrator Manager.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-4.png)

   1. Depois, escolha a opção 3, **Criar um subsistema**.  
![\[Opção 3 Criar um subsistema selecionada na tela Aplicações e subsistemas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-5.png)

   1. Insira o nome do subsistema como `sys1`.  
![\[Insira sys1 na tela Criar.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-6.png)

   1. Escolha a opção 3, **Gerenciamento de dados**.  
![\[Escolha a opção 3 Gerenciamento de dados na tela Criar em Aplicações e subsistema.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-7.png)

   1. Escolha a opção 5, pois o CardDemo aplicativo envolve arquivos sequenciais e VSAM.  
![\[Escolha a opção 5 para incluir arquivos sequenciais e VSAM.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-8.png)

   1. (Opcional). Pressione “R” para voltar à página **Criar menu** e revise as diferentes opções de configuração disponíveis.

   1. Na página **Criar**, digite “C” para criar o subsistema `sys1`.  
![\[Pressione “C” no teclado para criar o subsistema sys1.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-9.png)

   1. Revise as configurações e digite “C” para continuar com o restante das configurações do ambiente. Essas configurações de ambiente são pré-preenchidas devido às variáveis de ambiente necessárias definidas no arquivo de configuração `carddemo.env` e à existência da estrutura de pastas recomendada.

   1. Digite “y” para confirmar e salvar as configurações atuais do ambiente.  
![\[Exibe a configuração do ambiente do subsistema sys1 concluída. Também digite “y” para salvar as configurações atuais.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-10.png)

   1. Digite “y” para exibir o log ao criar o subsistema.  
![\[Mostra a compilação do sistema de tempo de execução NTT DATA COBOL de sys1 na tela.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-11.png)

   1. Pressione a **tecla Voltar** até voltar ao menu principal e sair da interface BAM selecionando a opção **Sair**.  
![\[Exibe o sistema de tempo de execução COBOL criado. Também solicita que você pressione Voltar para continuar.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-12.png)  
![\[Retorna ao menu Criar e mostra que o subsistema sys1 foi criado. E a configuração é atualizada. Solicita que você pressione Voltar para continuar.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-13.png)  
![\[Menu principal do Batch Administrator. Solicita inserir Q para sair desse menu.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-bpe-14.png)

1. Ative o subsistema BPE fornecendo o `batchenv` com o nome do subsistema `sys1`.

   ```
   source $EBMHOME/batchenv sys1
   ```

## Etapa 4: compilar e implantar CardDemo o aplicativo
<a name="tutorial-unikix-compile"></a>

Nesta etapa, você vai compilar os programas COBOL e implantar artefatos de aplicações, como JCL, procedimentos, arquivos de dados e definições de recursos do CICS.

1. Ative o CardDemo ambiente novamente fornecendo o arquivo de `carddemo.env` configuração.

   ```
   source $HOME/bin/carddemo.env
   ```

1. Navegue até o diretório de origem do COBOL.

   ```
   cd $MIGAPP_DIR/cbl
   ```

1. Compile o programa Cobol `CBACT01C.cbl` usando o script `compile`.

   ```
   compile CBACT01C.cbl
   ```

1. Compile todos os programas Cobol usando o script `compile.all`.

   ```
   compile.all
   ```

1. Navegue até o diretório de origem dos mapas BMS.

   ```
   cd $MIGAPP_DIR/bms
   ```

1. Compile o mapa BMS `COACTUP.bms` usando o script `compbms`.

   ```
   compbms COACTUP.bms
   ```

1. Compile todos os mapas BMS usando script `compbms.all`.

   ```
   compbms.all
   ```

1. Verifique os binários compilados para mapas COBOL e BMS.

   ```
   ls $PROJECT_ROOT/loadlib
   ls $PROJECT_ROOT/maps
   ```

1. Implante outros artefatos da aplicação, como JCL, procedimentos, arquivos de dados e definições de recursos do CICS usando o script `deploy_app`.

   ```
   deploy_app
   ```

1. Navegue até o diretório JCL do projeto.

   ```
   cd $PROJECT_ROOT/jcl
   ```

1. Converta JCL ACCTFILE em BPE JCL Macro. Use o comando `mvstrans`, utilizando a opção “-v” para verificação de JCL e a opção “-f” para criar a macro.

   ```
   mvstrans ACCTFILE -v
   mvstrans ACCTFILE -f
   ```

1. Converta o procedimento JCL REPROC na macro do procedimento BPE JCL. Use o comando `mvstrans` com a opção “-p” além da opção “-v” para verificação e a opção “-f” para criar a macro.

   ```
   mvstrans REPROC -v -p
   mvstrans REPROC -f -p
   ```

1. Traduza todos os procedimentos JCLs e JCL.

   ```
   for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out
   for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out
   ```

## Etapa 5: importar o catálogo BPE e TPE
<a name="tutorial-unikix-import"></a>

Nesta etapa, você vai importar o catálogo do BPE e TPE usando comandos diferentes.

1. Importe o catálogo do BPE usando o comando `loadcat`.

   ```
   loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
   ```

1. Acesse o diretório \$1KIXSYS.

   ```
   cd $KIXSYS
   ```

1. Importe o catálogo do TPE usando o comando `kiximpcat`.

   ```
   kiximpcat -c CATALOG -l CATALOG.lst
   ```

1. Importe as definições de recursos do CICS usando o comando kiximptbl.

   ```
   kiximptbl
   ```

## Etapa 6: iniciar e conectar o TPE ao BPE
<a name="unikix-tutorial-connect"></a>

Nesta etapa, você precisa iniciar a região TPE criada anteriormente junto com o gerenciador de BPE e conectá-la para poder executar o aplicativo de amostra CardDemo .

1. Execute o comando `kixverify` em todos os arquivos VSAM para garantir que eles sejam redefinidos e que todos os arquivos abertos anteriormente sejam fechados.

   ```
   kixverify -r ALL
   ```

1. Inicie a região TPE.

   ```
   kixregion start $KIXSYS
   ```

1. Certifique-se de que o BPE e o TPE estejam conectados. Isso é essencial, pois os arquivos VSAM são de propriedade do TPE e qualquer operação em lote que acesse o VSAM exigirá uma conexão com o TPE.

   ```
   ebmsys -t
   ```  
![\[Exibe o nome do subsistema como sys1. O TPE está conectado e o usuário do TPE é ec2-user.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-start-1.png)

## Etapa 7: executar o CardDemo aplicativo
<a name="unikix-tutorial-run-application"></a>

Nesta etapa, você executa o CardDemo aplicativo no emulador de TN3270 terminal.

A AMI UniKix de tempo de execução vem com o emulador de terminal TN3270 que você pode iniciar diretamente da UniKix instância EC2.

**Conecte-se ao TPE usando o emulador de TN3270 terminal**
+ Inicie o TN3270 terminal usando o `kixterm` comando.

  ```
  kixterm
  ```  
![\[A tela principal do aplicativo de UniKix CardDemo amostra TPE para mainframe.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-carddemo-00.png)

(Opcional). Se quiser usar o próprio emulador de terminal:

1. Obtenha o endereço IP da instância de tempo de UniKix execução no console do Amazon EC2.

1. Obtenha o número da porta para se conectar à região do TPE usando o emulador de TN3270 terminal. Você pode encontrar isso no TNServer ListenPort arquivo unikixrc.cfg.

   ```
   cat $KIXSYS/unikixrc.cfg
   ```  
![\[Exibe os detalhes do arquivo UniKix unikixrc.cfg com a porta do ouvinte como 15440.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-carddemo-1.png)

1. Configure seu emulador de TN3270 terminal para usar o endereço IP da instância de UniKix tempo de execução e o número da porta 15440.

**Transações on-line**

Esta seção pressupõe que você tenha se conectado ao emulador de TN3270 terminal usando o `kixterm` comando.

1. Depois de se conectar a partir do emulador de TN3270 terminal, pressione a tecla “Enter” para limpar a tela do TPE e inserir a transação inicial.

1. Na transação inicial CC00 (tela de login), digite o nome `USER001` de usuário e `PASSWORD` a senha.  
![\[Tela principal para CardDemo. Mostra que este é um CardDemo aplicativo de crédito para modernização do mainframe. Solicita que você insira o ID de usuário e a senha.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-carddemo-2.png)

1. Escolha a opção “01” no **menu principal** para ver as contas.  
![\[CardDemo menu principal do aplicativo no emulador com a opção selecionada como 1.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-carddemo-3.png)

1. Na tela **Exibir conta**, insira um número de conta (por exemplo, 00000000010). Você deve ver as informações da conta preenchidas a partir dos dados migrados.  
![\[Detalhes do CardDemo aplicativo com o número de conta inserido como 00000000010.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-carddemo-4.png)

1. Pressione a tecla “PF03” duas vezes para voltar à tela de login e saia do TN3270 terminal pressionando “Ctrl\$1C” (Windows) ou “Cmd\$1C” (Macbook).

**Trabalhos em lote**

1. Navegue até o diretório JCL.

   ```
   cd $MBMSUB
   ```

1. Envie o trabalho `MFCATGL1` e observe a saída do log do trabalho.

   ```
   BPESUB READCARD
   ```

1. Também é possível visualizar os logs de trabalhos no diretório `$SUBSYS_OUTDIR`.

   ```
   ls -lrt $SUBSYS_OUTDIR/*
   ```

Agora você implantou com sucesso o CardDemo aplicativo no tempo de UniKix execução da NTT DATA e verificou o aplicativo em execução navegando por algumas telas on-line do CICS e trabalhos em lote.

## Solução de problemas
<a name="tutorial-unikix-troubleshoot"></a>

A seguir estão alguns erros comuns que você pode encontrar ao configurar o CardDemo aplicativo.

### Erro: erro de licenciamento
<a name="tutorial-unikix-troubleshoot-license-issue"></a>

Se você receber um erro de falha de licença ao seguir este tutorial, pode ser que o **IMDSv2**esteja habilitado em seu EC2. Você pode resolver esse problema modificando a opção de metadados da instância **IMDSv2**para **Opcional**, conforme mencionado em [Restaurar o uso de IMDSv1 no guia do](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) usuário do *Amazon EC2*.

### Erro: o TPE não está conectado ao BPE
<a name="tutorial-unikix-troubleshoot-tpe-connection"></a>

Se o TPE não estiver conectado ao BPE, verifique se a **tabela de configuração do VSAM** está configurada corretamente com o diretório do BPE Node. Para acessar a tabela de configuração do VSAM, inicie o emulador de TN3270 terminal usando o seguinte comando:

```
kixterm
```

1. Insira o nome da transação como `CTBL`.

1. No menu **Gerenciador de tabelas**, escolha a opção **Tabelas padrão**.

1. Na tela Tabelas padrão, escolha a opção **Tabela de configuração do VSAM**.

1. Confira se **Conectar ao batch node?** está definido como "**S** e o Node Directory está correto.

![\[Tabela de configuração do VSAM no emulador de TN3270 terminal. Exibindo valores para cada um dos campos na tabela.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/unikix-troubleshoot.png)
