Tutorial: Implantar CardDemo aplicativo na NTT DATA - AWS Modernização do mainframe
Diagrama do fluxo de implantaçãoPré-requisitosEtapa 1: preparar o ambienteEtapa 2: criar uma região TPEEtapa 3: criar o nó e o subsistema do BPEEtapa 4: compilar e implantar CardDemo o aplicativoEtapa 5: importar o catálogo BPE e TPEEtapa 6: iniciar e conectar o TPE ao BPEEtapa 7: executar o CardDemo aplicativoSolução de problemas

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: Implantar CardDemo aplicativo na NTT DATA

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.

Diagrama do fluxo de implantação

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.

Pré-requisitos

  • Siga as instruções fornecidas em AWS Modernização do mainframe e reformulação da plataforma com a NTT DATA Como usar a AMI do NTT DATA UniKix Marketplace.

  • Modifique a opção de metadados da instância IMDSv2para Opcional, conforme mencionado em Restaurar o uso do IMDSv1 no guia do EC2 usuário da Amazon.

  • Baixe os componentes CardDemo de tempo de execução para a NTT DATA UniKix a partir do

    GitHub repositório.

  • Faça login na EC2 instância UniKix de tempo de execução comoec2-user.

  • Extraia os componentes CardDemo de tempo de execução baixados usando este link: 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 $HOME/bin com o seguinte comando:

      • chmod +x $HOME/bin/*

Etapa 1: preparar o ambiente

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 EC2 instância UniKix de tempo de execução comoec2-user.

  2. 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: EC2 

    ls -l /opt/software/

  3. 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/*/*

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

    sh $HOME/bin/create_project

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

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

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

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

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

    source $KIXSYS/bin/userenv

  5. Crie a região TPE executando o comando kixinstall2.

    kixinstall2

Etapa 3: criar o nó e o subsistema do BPE

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

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

    $INSTEBM $EBMHOME

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

    source $EBMHOME/batchenv

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

    2. Escolha a opção 2, Iniciar/(Parar) Batch Node para iniciar o nó do BPE.

      Em Ambientes do sistema, escolha a opção 2 Iniciar/Parar Bach Node.

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

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

    5. Depois, escolha a opção 3, Criar um subsistema.

      Opção 3 Criar um subsistema selecionada na tela Aplicações e subsistemas.

    6. Insira o nome do subsistema como sys1.

      Insira sys1 na tela Criar.

    7. Escolha a opção 3, Gerenciamento de dados.

      Escolha a opção 3 Gerenciamento de dados na tela Criar em Aplicações e subsistema.

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

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

    10. Na página Criar, digite “C” para criar o subsistema sys1.

      Pressione “C” no teclado para criar o subsistema sys1.

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

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

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

    14. 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.
      Retorna ao menu Criar e mostra que o subsistema sys1 foi criado. E a configuração é atualizada. Solicita que você pressione Voltar para continuar.
      Menu principal do Batch Administrator. Solicita inserir Q para sair desse menu.

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

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

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

    cd $MIGAPP_DIR/cbl

  3. Compile o programa Cobol CBACT01C.cbl usando o script compile.

    compile CBACT01C.cbl

  4. Compile todos os programas Cobol usando o script compile.all.

    compile.all

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

    cd $MIGAPP_DIR/bms

  6. Compile o mapa BMS COACTUP.bms usando o script compbms.

    compbms COACTUP.bms

  7. Compile todos os mapas BMS usando script compbms.all.

    compbms.all

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

    ls $PROJECT_ROOT/loadlib
ls $PROJECT_ROOT/maps

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

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

    cd $PROJECT_ROOT/jcl

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

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

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

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*

  2. Acesse o diretório $KIXSYS.

    cd $KIXSYS

  3. Importe o catálogo do TPE usando o comando kiximpcat.

    kiximpcat -c CATALOG -l CATALOG.lst

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

    kiximptbl

Etapa 6: iniciar e conectar o TPE ao BPE

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

  2. Inicie a região TPE.

    kixregion start $KIXSYS

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

Etapa 7: executar o CardDemo aplicativo

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

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

Conecte-se ao TPE usando TN327 0 emulador de terminal

  • Inicie o terminal TN327 0 usando o kixterm comando.

    kixterm
    A tela principal do aplicativo de UniKix CardDemo amostra TPE para mainframe.

(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 EC2 console da Amazon.

  2. Obtenha o número da porta para conexão com a região TPE usando o emulador de terminal TN327 0. 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.

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

Transações on-line

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

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

  2. Na transação inicial CC00 (tela de login), digite USER001 para nome de usuário e PASSWORD para 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.

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

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

  5. Pressione a tecla “PF03” duas vezes para voltar à tela de login e saia do terminal TN327 0 pressionando “Ctrl+C” (Windows) ou “Cmd+C” (Macbook).

Trabalhos em lote

  1. Navegue até o diretório JCL.

    cd $MBMSUB

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

    BPESUB READCARD

  3. 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 seguir estão alguns erros comuns que você pode encontrar ao configurar o CardDemo aplicativo.

Erro: erro de licenciamento

Se você receber um erro de falha de licença ao seguir este tutorial, pode ser que o IMDSv2esteja habilitado em seu EC2. Você pode resolver esse problema modificando a opção de metadados da instância IMDSv2para Opcional, conforme mencionado em Restaurar o uso de IMDSv1 no guia do EC2 usuário da Amazon.

Erro: o TPE não está conectado ao BPE

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 terminal TN327 0 usando o seguinte comando:

kixterm

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

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

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

  4. 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 terminal TN327 0. Exibindo valores para cada um dos campos na tabela.