Configurar o CICS BankDemo para o Micro Focus Enterprise Developer 4.0 no Azure

Ao configurar o Enterprise Server 4.0 e o Enterprise Developer 4.0 da Micro Focus no Azure, você pode testar as implantações de cargas de trabalho do IBM z/OS. Este artigo mostra como configurar o CICS BankDemo, um aplicativo de exemplo fornecido com o Enterprise Developer.

CICS significa Sistema de Controle de Informações do Cliente, a plataforma de transação usada por muitos dos aplicativos de mainframe online. O aplicativo BankDemo é ótimo para aprender como o Enterprise Server e o Enterprise Developer operam e como gerenciar e implantar um aplicativo real completo com terminais de tela verdes.

Observação

Em breve: instruções para configurar o Micro Focus Enterprise Server 5.0 em VMs do Azure.

Pré-requisitos

• Uma VM com Enterprise Developer. Tenha em mente que o Enterprise Developer tem uma instância completa do Enterprise Server para fins de desenvolvimento e teste. Esta é a instância do Enterprise Server usada para a demonstração.

• SQL Server 2017 Edição Express. Baixe e instale na VM do Enterprise Developer. O Enterprise Server requer um banco de dados para o gerenciamento de regiões CICS e o aplicativo BankDemo também usa um banco de dados SQL Server chamado BANKDEMO. Esta demonstração pressupõe que você esteja usando SQL Server Express para ambos os bancos de dados. Na instalação, selecione a opção básica.

• SSMS (SQL Server Management Studio). O SSMS é usado para gerenciar os bancos de dados e executar um script T-SQL. Baixe e instale na VM do Enterprise Developer.

• O Visual Studio 2019 com o mais recente service pack ou a Visual Studio Community, que você pode baixar gratuitamente.

• Rumba Desktop ou outro emulador 3270.

Configurar o ambiente do Windows

Depois de instalar o Enterprise Developer 4.0 na VM, você deve configurar a instância do Enterprise Server que vem com ele. Para fazer isso, você precisa instalar alguns recursos adicionais do Windows da seguinte maneira.

1. Use o RDP para fazer logon na VM do Enterprise Server 4.0 que você criou.

2. Clique no ícone de Pesquisa ao lado do botão Iniciar e digite Recursos do Windows. Assistente de Adição de Funções e Recursos do Gerenciador do Servidor é aberto.

3. Selecione Função do servidor Web (IIS) e, em seguida, verifique as seguintes opções:

   • Ferramentas de gerenciamento da Web
   • Compatibilidade de gerenciamento do IIS 6 (selecione todos os recursos disponíveis)
   • Console de Gerenciamento IIS
   • Scripts e Ferramentas de Gerenciamento do IIS
   • Serviço de Gerenciamento do IIS

4. Selecione Serviços da World Wide Web e verifique as seguintes opções:

   Recursos de desenvolvimento de aplicativos:

   • Extensibilidade .NET
   • ASP.NET
   • Recursos HTTP comuns: adicionar todos os recursos disponíveis
   • Integridade e diagnóstico: adicionar todos os recursos disponíveis
   • Segurança:
     • Autenticação Básica
     • Autenticação do Windows

5. Selecione Serviço de ativação de processos do Windows e todos os seus filhos.

6. Para Recursos, marque Microsoft .NET Framework 3.5.1 e verifique as seguintes opções:

   • Ativação HTTP do Windows Communication Foundation
   • Ativação não HTTP do Windows Communication Foundation

7. Para Recursos, verifique Microsoft .NET Framework 4.6 e verifique as seguintes opções:

   • Ativação de Pipe Nomeado

   • Ativação TCP

   • Compartilhamento de porta TCP

     

8. Quando você tiver selecionado todas as opções, clique em Avançar para instalar.

9. Após os recursos do Windows, acesse Painel de controle> Sistema e Segurança > Ferramentas administrativas e selecione Serviços. Role para baixo e verifique se os seguintes serviços estão em execução e definidos como Automáticos:

   • NetTcpPortSharing
   • Adaptador ouvinte do Net.Pipe
   • Adaptador ouvinte do Net.Tcp

10. Para configurar o suporte IIS e WAS, no menu, localize o prompt de comando Micro Focus Enterprise Developer (64 bits) e execute como Administrador.

11. Digite wassetup –i e pressione Enter.

12. Depois que o script for executado, você poderá fechar a janela.

Configurar a conta do sistema local para SQL Server

Alguns processos do Enterprise Server precisam ser capazes de entrar no SQL Server e criar bancos de dados e outros objetos. Esses processos usam a conta sistema local, portanto, você deve conceder autoridade sysadmin para essa conta.

1. Inicie o SSMS e clique em Conectar para conectar-se ao servidor SQLEXPRESS local usando a autenticação do Windows. Ele deve estar disponível na lista Nome do servidor.

2. À esquerda, expanda a pasta Segurança e selecione Logons.

3. Selecione NT AUTHORITY\SYSTEM e escolha Propriedades.

4. Selecione Funções de servidor e marque sysadmin.

   

Criar o banco de dados BankDemo e todos os seus objetos

1. Abra o Windows Explorer e navegue até C:\Users\Public\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo\SQL.

2. Copie o conteúdo do arquivo BankDemoCreateAll.SQL para a área de transferência.

3. Abra o SSMS. À direita, clique em Servidor e selecione Nova consulta.

4. Cole o conteúdo da área de transferência na caixa Nova consulta.

5. Execute o SQL clicando em Executar na guia Comando acima da consulta.

A consulta deve ser executada sem erros. Quando estiver concluída, você terá o banco de dados de exemplo do aplicativo BankDemo.

Verifique se as tabelas e os objetos do banco de dados foram criados

1. Clique com o botão direito do mouse no banco de dados BANKDEMO e selecione Atualizar.

2. Expanda o Banco de dados e selecione Tabelas. Você deverá ver algo semelhante ao que é exibido a seguir.

   

Criar o aplicativo no Enterprise Developer

1. Abra o Visual Studio e entre.

2. Na opção de menu Arquivo, selecione Abrir projeto/solução, navegue até C:\Usuários\Público\Documentos\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo e selecione o arquivo sln.

3. Reserve algum tempo para examinar os objetos. Os programas COBOL são exibidos no Gerenciador de Soluções com a extensão CBL, juntamente com CPY (CopyBooks) e JCL.

4. Clique com o botão direito do mouse no projeto BankDemo2 e selecione Definir como projeto de inicialização.

   Observação

   O projeto BankDemo usa HCOSS (opção de compatibilidade de host para SQL Server), que não é usada nesta demonstração.

5. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto BankDemo2 e selecione Compilar.

   Observação

   A criação no nível da solução resulta em erros, pois HCOSS não foi configurado.

6. Quando o projeto for compilado, examine a janela de saída. Ele deverá ter a aparência mostrada na imagem abaixo.

   

Implantar o aplicativo BankDemo no banco de dados de região

1. Abra um prompt de comando do Enterprise Developer (64 bits) como administrador.

2. Navegue até %PUBLIC%\Documents\Micro Focus\Enterprise Developer\samples\Mainframe\CICS\DotNet\BankDemo.

3. No prompt de comando, execute bankdemodbdeploy e inclua o parâmetro do banco de dados no qual implantar, por exemplo:

   bankdemodbdeploy (local)/sqlexpress
   

Observação

Lembre-se de usar uma barra (/), e não uma barra invertida (\). Esse script é executado por um tempo.

Criar a região BankDemo no administrador do Enterprise para .NET

1. Abra a interface do usuário do Enterprise Server para Administração de .NET.

2. Para iniciar o snap-in do MMC, no menu Iniciar do Windows, escolha Micro Focus Enterprise Developer > Configuração > Enterprise Server para administrador .NET. (Para o Windows Server, escolha Micro Focus Enterprise Developer > Enterprise Server para administrador .NET).

3. Expanda o contêiner Regiões no painel esquerdo e clique com o botão direito do mouse em CICS.

4. Selecione Definir região para criar uma nova região de CICS chamada BANKDEMO, hospedada no banco de dados (local).

5. Forneça a instância do servidor de banco de dados, clique em Avançar e digite o nome da região BANKDEMO.

   

6. Para selecionar o arquivo de definição de região para o banco de dados entre regiões, localize region_bankdemo_db.config em C:\Usuários\Público\Documentos\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\DotNet\BankDemo.

   

7. Clique em Concluir.

Criar definições de recursos XA

1. No painel esquerdo da interface do usuário do Enterprise Server para Administração de .NET, expanda Sistema e, em seguida, Definições de recurso XA. Essa configuração define como a região interopera com o Enterprise Server e os bancos de dados de aplicativo.

2. Clique com o botão direito do mouse em Definições de recursos XA e selecione Adicionar instância de servidor.

3. Na caixa suspensa, selecione Instância do serviço de banco de dados. Será o computador local SQLExpress.

4. Selecione a instância sob o contêiner Definições de recursos XA (machinename\sqlexpress) e clique em Adicionar.

5. Selecione Definição de recurso XA do banco de dados e digite BANKDEMO em Nome e Região.

   

6. Clique nas reticências ( ... ) para abrir o assistente de cadeia de conexão. Em Nome do servidor, digite (local)\SQLEXPRESS. Para Logon, selecione Autenticação do Windows. Para o nome do banco de dados, digite BANKDEMO

   

7. Teste a conexão.

Iniciar a região BANKDEMO

Observação

A primeira etapa é importante: você deve definir a região para usar a definição de recurso XA que acabou de criar.

1. Navegue até a região de CICS BANKDEMO sob o Contêiner Regiões e, em seguida, selecione Editar arquivo de inicialização de região no painel Ações. Role para baixo até as propriedades do SQL e insira bankdemo como nome do recurso XA ou use as reticências para selecioná-lo.

2. Clique no botão Salvar para salvar as alterações.

3. Clique com o botão direito do mouse na região de CICS BANKDEMO no painel de console e selecione Iniciar/Parar região.

4. Na parte inferior da caixa Iniciar/Parar região que aparece no painel central, selecione Iniciar. Depois de alguns segundos, a região é iniciada.

   

   

Criar um ouvinte

Crie um ouvinte para as sessões TN3270 que acessam o aplicativo BankDemo.

1. No painel esquerdo, expanda Editores de configuração e selecione Ouvinte.

2. Clique no ícone Abrir arquivo e selecione o arquivo seelistener.exe.config. Esse arquivo será editado e carregado toda vez que o Enterprise Server for iniciado.

3. Observe as duas regiões definidas anteriormente (ESDEMO e JCLDEMO).

4. Para criar uma nova região para BANKDEMO, clique com o botão direito do mouse em Regiões e selecione Adicionar região.

5. Selecione a região BANKDEMO.

6. Adicione um canal TN3270 clicando com o botão direito do mouse em região BANKDEMO e selecionando Adicionar canal.

7. Em Nome, insira TN3270. Em Porta, insira 9024. O aplicativo ESDEMO usa a porta 9230 para que você precise usar uma porta diferente.

8. Para salvar o arquivo, clique em Salvar ou escolha Arquivo>Salvar.

9. Para iniciar o ouvinte, clique no ícone Iniciar ouvinte ou escolha Opções>Iniciar ouvinte.

   

Configurar o Rumba para acessar o aplicativo BankDemo

A última coisa que você precisa fazer é configurar uma sessão 3270 usando o Rumba, um emulador 3270. Esta etapa permite que você acesse o aplicativo BankDemo por meio do ouvinte que você criou.

1. No menu Iniciar do Windows, inicie o Rumba Desktop.

2. No item de menu Conexões, selecione TN3270.

3. Clique em Inserir e digite 127.0.0.1 para o endereço IP e 9024 para a porta definida pelo usuário.

4. Na parte inferior da caixa de diálogo, clique em Conectar. Uma tela CICS preta é exibida.

5. Digite bank para exibir a tela inicial de 3270 para o aplicativo BankDemo.

6. Para ID de usuário, digite B0001 e como senha, digite qualquer coisa. A primeira tela BANK20 é aberta.

Parabéns! Agora você está executando um aplicativo CICS no Azure usando o Micro Focus Enterprise Server.

Próximas etapas

• Executar o Enterprise Server em contêineres do Docker no Azure
• Migração de mainframe – Portal
• Máquinas virtuais
• Solução de problemas