Criando os Exemplos do JCICS

Crie os projetos de exemplos do JCICS para entender como desenvolver aplicativos Java™ que possam ser executados no CICS.

Procedimento

  1. No IDE do Eclipse, abra a perspectiva Java.
  2. Configure a plataforma de destino para a liberação mais recente de CICS trabalhar com os exemplos do JCICS. Caso contrário, erros de compilação podem ocorrer na criação dos exemplos em sua área de trabalho.
    1. Clique em Janela > Preferências a partir da barra de menus do ambiente de trabalho.
    2. Expanda Desenvolvimento de Plug-in e clique em Plataforma de Destino.
    3. Clique em Incluir para criar uma definição de destino.
    4. Clique em Modelo e selecione CICS TS V5.2 na lista.
    5. Clique em Avançar no assistente e, em seguida, clique em Concluir.
    6. Selecione a definição de destino e clique em OK.
  3. Para criar um projeto de plug-in de exemplo, use um dos métodos a seguir para abrir o assistente Novo Exemplo:
    • 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.
  4. Na pasta Exemplos do CICS > Java, selecione Exemplos de Hello do CICS e clique em Avançar.
    Captura de tela mostrando o assistente com exemplos disponíveis na pasta Java.
    • Os exemplos API do CICS demonstram como usar filas de dados temporários, filas de armazenamento temporário e canais e COMMAREAs em programas Java.
    • O exemplo de OSGi do pacote configurável do CICS demonstra como criar um pacote configurável do CICS para implementar no CICS.
    • Os exemplos de hello do CICS demonstram duas maneiras de fazer um teste Hello World simples no CICS.
    • O exemplo da web do CICS demonstra como usar classes para interagir com um navegador da web.
  5. 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 exemplo de Hello World é com.ibm.cics.server.examples.hello.
  6. Clique em Concluir. O Eclipse cria o projeto de plug-in que contém o exemplo de Hello World do JCICS como um pacote configurável do OSGi.
    Dica: Se o projeto não for construído e o seguinte erro ocorrer, assegure-se de que tenha concluído a etapa 2 com êxito:
    O pacote configurável 'com.ibm.cics.server' não pode ser resolvido
  7. Expanda o projeto na visualização do Package Explorer.
    Captura de tela da visualização do Package Explorer com o projeto de exemplo de Hello World expandido.
    • A pasta Dependências de Plug-in contém as dependências para o pacote configurável OSGi. Neste exemplo, o pacote configurável tem uma dependência do pacote configurável OSGi que contém o JCICS. Essas informações também são capturadas no manifesto do projeto.
    • A pasta src contém a fonte Java para os exemplos. É possível pesquisar os arquivos de origem para ver as classes JCICS que são usadas e usar a ajuda de contexto para pesquisar uma classe específica. Também é possível abrir a visualização Javadoc para ver os detalhes da API para o conteúdo selecionado, por exemplo, um método ou uma classe.
    • A pasta META-INF contém o manifesto para o projeto. O manifesto contém os cabeçalhos OSGi para descrever o pacote configurável OSGi.
  8. Crie projetos de plug-in para a API CICS e exemplos da web do CICS usando o assistente Novo Exemplo. É possível visualizar a fonte Java para entender como as classes JCICS são usadas para trabalhar com programas e aplicativos da web.

Resultados

Três projetos de plug-in foram criados no Eclipse para os exemplos do JCICS. Esses projetos contêm informações de empacotamento dos pacotes configuráveis OSGi, incluindo dependências de plug-in e ambientes Java de destino.