Implementando os Exemplos de JCICS

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

Antes de Iniciar

Você deve criar os projetos de exemplo do JCICS, conforme descrito em Introdução aos Exemplos de 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. O CICS deve ter acesso de leitura e execução para o diretório.

O 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 seguintes opções:
    • Na barra de menus do Eclipse, clique em Arquivo > Novo > Exemplo.
    • Clique na seta para baixo no ícone Novo Assistente e clique em Exemplo.
    • Na visualização Explorador de Projetos, clique com o botão direito do mouse e clique emNovo > Exemplo.
  3. Na pasta CICS Java, selecione Exemplo OSGi de Pacote Configurável do 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 CICS é com.ibm.cics.server.examples.
  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. Um arquivo de programa também faz parte do projeto de pacote configurável de amostra que você pode usar para implementar um projeto para CICS e instalar um pacote configurável.
  6. Abra o arquivo web.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 de pacote configurável do CICS e selecione Exportar para Sistema de Arquivos z/OS UNIX.
    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. Pode ser preciso criar uma conexão a uma máquina host de destino se você não tiver configurado uma conexão anteriormente.
    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 de JVMSERVER, DFH$JVMS, 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

Você implementou com êxito o pacote configurável do CICS para zFS e criou os recursos do CICS que são necessários para executar os exemplos de JCICS.

O que Fazer Depois

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