Criando um Projeto de Plug-in

Crie seu aplicativo Java™ do CICS como um projeto de plug-in do Eclipse que seja compatível com a especificação OSGi. A Plataforma de Serviços OSGi fornece um mecanismo para desenvolver aplicativos usando um modelo de componente e implementando esses aplicativos em uma estrutura como pacotes configuráveis OSGi. O projeto de plug-in é um pacote configurável OSGi e contém todos os arquivos e artefatos necessários para o aplicativo Java do CICS, incluindo a biblioteca de classes JCICS para acessar recursos do CICS e interagir com programas que são escritos em outras linguagens. O aplicativo concluído é então incluído em um projeto de pacote configurável CICS antes de ser exportado para o sistema host.

Sobre Esta Tarefa

Esta tarefa cria um novo projeto de plug-in. É possível deixar as configurações com seus valores padrão, a menos que haja instrução em contrário. Quando o projeto é criado, você deve editar o manifesto e incluir as dependências da API JCICS.

Procedimento

  1. Na barra de menus do Eclipse, clique em Arquivo > Novo > Projeto para abrir o assistente de Novo Projeto.
  2. Selecione Projeto de Plug-in na lista fornecida e, em seguida, clique em Avançar para abrir o assistente Novo Projeto de Plug-in.
  3. No campo Nome do Projeto, insira um nome para o projeto e na seção Plataforma de Destino, selecione uma estrutura OSGi e selecione padrão no menu.
    Uma captura de tela do Assistente Novo Plug-in
    Clique em Avançar.
    A área de janela Conteúdo é exibida.
  4. No campo Versão, remova o ".qualifier" do final do número da versão. O qualificador não é suportado atualmente.
  5. No campo Ambiente de Execução, selecione o nível de Java que corresponde ao ambiente de execução em sua plataforma de destino de tempo de execução do CICS.
    Uma captura de tela do campo Ambiente de Execução com o menu selecionado e mostrando a lista de opções disponíveis para seleção.
  6. Limpe a caixa de seleção Gerar um ativador e clique em Concluir. O novo projeto de plug-in é criado na visualização do Package Explorer.
  7. Necessário: Requisito: Você deve agora editar o arquivo de manifesto do plug-in e incluir as dependências da API JCICS. Se você não executar essas etapas, será capaz de exportar e instalar o pacote configurável, mas ele não poderá ser executado.
    1. Na visualização do Package Explorer, clique com o botão direito do mouse no nome do projeto e clique em Ferramentas PDE > Abrir Manifesto. O arquivo de manifesto é aberto no editor de manifesto.
    2. Selecione a guia Dependências e, na seção Pacotes Importados, clique em Incluir. O diálogo Seleção de Pacote é aberto.
    3. Selecione o pacote com.ibm.cics.server e clique em OK. O pacote é exibido na lista de Pacotes Importados.
    4. Opcional: Opcional: Repita a etapa anterior para instalar o seguinte pacote, se necessário, para o seu aplicativo:
      Tabela 1.
      Pacote Descrição
      com.ibm.record A API Java para programas legados que usam IByteBuffer da Estrutura de Registro Java que era fornecida com o VisualAge. Anteriormente no arquivo dfjcics.jar.
      com.ibm.cics.samples Amostras para redirecionar System.out e System.err. Substitui o arquivo dfjoutput.jar.
    5. Pressione Ctrl +S para salvar o arquivo de manifesto.

Resultados

O novo projeto de plug-in é criado contendo as dependências da API JCICS.

O que Fazer Depois

Agora é possível criar seu aplicativo Java do CICS. Se for novato no desenvolvimento de aplicativos Java para CICS, será possível usar as amostras de JCICS fornecidas com o CICS Explorer SDK para ajudá-lo a iniciar.

Nota: Após ter desenvolvido o aplicativo, você deverá incluir uma declaração MainClass do CICS no arquivo de manifesto e declarar as classes usadas no aplicativo. Consulte o link relacionado para obter informações adicionais.

Para obter informações adicionais sobre o desenvolvimento de plug-ins, consulte a seção "Guia do Desenvolvedor de Plug-in da Plataforma" na documentação da Ajuda do Eclipse.

Quando o aplicativo Java for concluído, você deverá implementá-lo em um pacote configurável CICS para zFS. Os pacotes configuráveis CICS podem conter um ou mais plug-ins e são a unidade de implementação para seu aplicativo no CICS.