Implementando os Exemplos de JCICS

É possível usar o pacote configurável do CICS de exemplo no CICS Explorer SDK para implementar os exemplos de JCICS para uma região do CICS.

Antes de Iniciar

Deve-se criar todos os três projetos de exemplo JCICS, conforme descrito em Criando os Exemplos do JCICS.

Sobre Esta Tarefa

O CICS carrega e executa aplicativos Java a partir do zFS, assim, você deve implementar os seus aplicativos compilados em um diretório adequado no zFS. É possível criar um diretório adequado no zFS usando a perspectiva z/OS no CICS Explorer. O CICS deve ter acesso de leitura e execução para o diretório.

O CICS Explorer SDK fornece suporte para a implementação de aplicativos Java em um projeto de pacote configurável doCICS para zFS. Um projeto de pacote configurável do CICS agrupa um conjunto de pacotes configuráveis OSGi que são logicamente implementados e gerenciados como uma única unidade. É possível usar o projeto de pacote configurável do CICS para implementar os exemplos de JCICS para uma região do CICS.

Procedimento

  1. No IDE do Eclipse, abra a perspectiva Java.
  2. Abra o assistente Novo Exemplo usando uma das opções a seguir:
    • Na barra de menus do Eclipse, clique em Arquivo > Novo > Exemplo.
    • Clique na seta para baixo no ícone Novo e clique em Exemplo.
    • Na visualização Explorador de Projetos ou Package Explorer, clique com o botão direito do mouse e clique em Novo > Exemplo.
  3. Na pasta Exemplos do CICS > Java, selecione Exemplo do Pacote Configurável do Aplicativo do CICSExemplo de OSGi do Pacote Configurável de CICS e clique em Avançar.
  4. No campo Nome do projeto, insira um nome para o novo projeto. Por padrão, o Eclipse cria um nome que é a localização da pasta dos exemplos na área de trabalho, seguida do nome do exemplo. Por exemplo, o nome do projeto padrão para o pacote configurável do CICS é com.ibm.cics.server.examples.bundle.
  5. Clique em Concluir. O Eclipse cria o projeto de pacote configurável do CICS que contém um manifesto e três recursos. Esses recursos referenciam os três pacotes configuráveis OSGi.
  6. Abra o arquivo cicsweb.osgibundle para verificar seu conteúdo. Esse arquivo está no formato XML e contém o nome simbólico e a versão do pacote configurável OSGi. Contém também o nome de um servidor JVM de amostra. O servidor JVM é o ambiente de tempo de execução para aplicativos Java noCICS. Ao criar seus próprios aplicativos, você deverá fornecer o nome do servidor JVM de destino nesse arquivo.
  7. Implemente o pacote configurável CICS para zFS:
    1. Clique com o botão direito do mouse no projeto do pacote configurável no CICS e selecione Exportar Projeto de Pacote Configurável para o UNIX File System do z/OS.
    2. Selecione Exportar para um local específico no sistema de arquivos e clique em Avançar.
    3. Insira suas credenciais de FTP se necessário. Se não tiver configurado anteriormente uma conexão, uma conexão deverá ser criada com uma máquina host de destino.
    4. Navegue para um diretório no qual deseja implementar o pacote configurável CICS e clique em Concluir.
    O pacote configurável doCICS é implementado no diretório especificado.
  8. Abra a perspectiva SM do CICS. Na visualização CICSplex Explorer, selecione a região do CICS na qual deseja executar os programas de exemplo do JCICS.
  9. Instale o recurso JVMSERVER, DFHJVMS, que está no grupo de amostras DFH$OSGI. O recurso cria um servidor JVM de amostra na região CICS que contém uma estrutura OSGi. Esse nome de recurso corresponde ao nome do servidor JVM que foi especificado no manifesto do pacote configurável doCICS. É possível verificar o status do servidor JVM clicando em Operações > Java > Servidores JVM.
  10. Abra a visualização Definições de Pacote Configurável clicando em Definições > Definições de Pacote Configurável. Essa visualização lista todas as definições de pacote configurável para a região do CICS.
  11. Na visualização Definições de Grupo de Recursos, selecione o grupo DFH$OSGI fornecido. Se essa visualização não estiver aberta, selecione Janela > Mostrar Visualização para abri-la na perspectiva do Eclipse. A visualização Definições de Pacote Configurável é filtrada para exibir a definição do recurso DFH$OSGB.
  12. Copie a definição do recurso para um novo grupo para editar os atributos:
    1. Clique com o botão direito do mouse em DFH$OSGB e clique em Copiar.
    2. Clique com o botão direito do mouse em qualquer lugar na visualização Definições de Grupo de Recursos e selecione Colar.
    3. Insira um novo nome de grupo e clique em OK.
  13. Edite a definição de recurso BUNDLE no novo grupo para mudar o diretório do pacote configurável para corresponder ao local do pacote configurável do CICS implementado.
  14. Clique com o botão direito do mouse na definição para instalar o recurso BUNDLE. É possível verificar o BUNDLE instalado no estado ENABLED clicando em Operações > Pacotes Configuráveis. Também é possível verificar a lista de pacotes configuráveis OSGi clicando em Operações > Java > Pacotes Configuráveis OSGi.
  15. Para executar os exemplos em um servidor JVM, instale o grupo de amostra DFH$OSGI na região do CICS. Esse grupo contém as definições de recursos para todas as amostras. Os recursos da amostra BUNDLE e JVMSERVER não são instalados porque você já criou recursos com o mesmo nome. Ao instalar o grupo, o CICS cria os recursos que são necessários para executar os exemplos.

Resultados

O exemplo de pacote configurável do CICS para zFS foi implementado com sucesso, e os recursos do CICS que são obrigatórios foram criados para executar os exemplos do JCICS.

O que Fazer Depois

É possível executar os exemplos de JCICS, conforme descrito em Executando os Exemplos de JCICS.