Incluindo Recursos Em um Projeto de Pacote Configurável do CICS

Ao incluir definições de recursos em um projeto de pacote configurável do CICS, o CICS cria dinamicamente recursos durante a implementação e instalação do pacote configurável na região CICS.

Antes de Iniciar

Você deve criar um projeto de pacote configurável do CICS antes de incluir recursos nele. Para obter informações adicionais, consulte Criando um Projeto de Pacote Configurável do CICS.

Sobre Esta Tarefa

Algumas características de recursos do CICS são alteradas porque eles são definidos em um pacote configurável do CICS e são criados dinamicamente como parte da implementação de um pacote configurável. Os ciclos de vida de recursos do CICS que são criados dessa maneira não podem ser gerenciados de forma independente do recurso BUNDLE. Eles devem ser gerenciados por meio do pacote configurável do CICS. Por causa da interdependência do ciclo de vida do pacote configurável e do recurso, os arquitetos de aplicativos devem considerar cuidadosamente qual conjunto de recursos para um aplicativo deve ter seu ciclo de vida ligado ao ciclo de vida de um pacote configurável do CICS. Para entender mais sobre as possíveis implicações da definição de recursos em pacotes configuráveis do CICS, consulte Características de Recursos de Pacotes Configuráveis.

É possível referenciar um ou vários pacotes configuráveis do CICS em um pacote configurável de aplicativo. Empacotando seu aplicativo dessa maneira, é possível implementar um aplicativo e seus pacotes configuráveis como uma única entidade no CICS, facilitando a atualização e o gerenciamento do aplicativo no CICS. Um pacote configurável do CICS pode ser instalado em regiões do CICS por mais de um aplicativo se ele contiver apenas recursos que são elegíveis para várias versões.

Os aplicativos implementados em plataformas que usam os recursos do CICS que são suportados como recursos privados, em combinação com outros recursos projetados para aplicativos e com recursos importados, são elegíveis para várias versões. Os recursos a seguir são suportados como parte dos aplicativos com várias versões:
  • Recursos PROGRAM definidos em pacotes configuráveis do CICS que fazem parte do aplicativo
  • Recursos LIBRARY definidos em pacotes configuráveis do CICS que fazem parte do aplicativo
  • Políticas
  • Instruções de pontos de entrada do aplicativo
  • Qualquer recursos que seja definido como uma dependência, ou importação, para o aplicativo

Um pacote configurável do CICS que contém outros tipos de recursos não pode ser incluído em outros aplicativos instalados nas mesmas regiões do CICS na plataforma e você não pode incluí-lo na plataforma se ele já tiver sido instalado para um aplicativo. Se seu aplicativo exigir um recurso que não seja suportado para várias versões e já tiver sido usado em um pacote configurável do CICS que foi instalado no tipo de região de destino na plataforma, crie um novo projeto de pacote configurável do CICS. Declare o recurso como uma dependência para o novo pacote configurável do CICS especificando uma importação no arquivo de manifesto. Em seguida, inclua o novo projeto de pacote configurável do CICS no projeto do aplicativo. Para obter instruções sobre como declarar um recurso como uma dependência, consulte Definindo Dependências de Pacote Configurável.

Ao definir um recurso TRANSACTION em um pacote configurável CICS e implementar o pacote configurável CICS como parte de um aplicativo, ou incluir o pacote configurável CICS em uma plataforma, a instalação automática do programa inicial para a transação não é suportada. Para um recurso TRANSACTION definido em um pacote configurável CICS que está implementado como parte de um aplicativo, é necessário definir e implementar o recurso PROGRAM para o programa inicial da transação como parte do mesmo aplicativo. Para um recurso TRANSACTION definido em um pacote configurável CICS que está implementado com uma plataforma, é necessário definir e implementar o recurso PROGRAM para o programa inicial da transação de uma das maneiras a seguir:
  • Em um pacote configurável CICS que está implementado com a plataforma.
  • Como parte de um aplicativo que está implementado na plataforma.
  • Nas regiões CICS que fazem parte da plataforma, usando um pacote configurável CICS independente, o CSD CICS, ou o repositório de dados SM CICSPlex.

Para definir um recurso em um projeto de pacote configurável do CICS, siga estas etapas:

Procedimento

  1. Na visualização Explorador de Projetos, clique com o botão direito no projeto de pacote configurável do CICS e clique em Novo.
  2. Selecione o recurso que você deseja incluir do menu; por exemplo, um programa, biblioteca, transação ou definição de mapa de URI.
    Dica: Os pacotes configuráveis do CICS suportam nomes compostos por letras maiúsculas e minúsculas para recursos onde eles são suportados no CICS. No entanto, seu sistema de arquivos pode não permitir que arquivos com o mesmo nome, mas compostos por letras maiúsculas e minúsculas residam no mesmo projeto de pacote configurável do CICS. Se você precisar de nomes de recursos duplicados que usam maiúsculas e minúsculas, defina esses recursos em projetos de pacote configurável do CICS separados.
  3. Preencha os campos necessários no assistente.
    1. Para um subconjunto de recursos do CICS, você pode incluir uma operação do aplicativo se o recurso for um ponto de entrada para um aplicativo.
    2. Para um servidor JVM, você pode optar por criar um perfil JVM usando um dos modelos fornecidos, OSGi, Axis2 ou Liberty, ou usar um perfil JVM existente que está no pacote configurável do CICS ou importar um perfil JVM existente para o pacote configurável do CICS de outro lugar na área de trabalho ou do sistema de arquivos local. Depois de concluir o assistente, edite o perfil JVM para atender os requisitos do sistema, seguindo as instruções em Editando Recursos Definidos em um Projeto de Pacote Configurável do CICS.
    3. Para um pipeline, você pode optar por criar um arquivo de configuração de pipeline usando um dos arquivos de configuração de pipeline de amostra fornecidos pelo CICS ou importar um arquivo de configuração existente do sistema de arquivos local ou da área de trabalho local. Depois de concluir o assistente, edite o arquivo de configuração de pipeline para incluir os manipuladores de mensagens, os programas de processamento de cabeçalho e os manipuladores de aplicativos que você deseja incluir nele, seguindo as instruções em Editando Recursos Definidos em um Projeto de Pacote Configurável do CICS.
    4. Para um serviço da web, importe um arquivo de ligação de serviço da web do sistema de arquivos local ou da área de trabalho local para criar a definição de WEBSERVICE. Você pode optar por importar um documento WSDL ou um archive WSDL a ser empacotado no pacote configurável, e para um fornecedor de serviços você pode marcar a caixa de seleção para incluir uma definição de PROGRAM no pacote configurável. Observe que o serviço da web é criado com a configuração padrão que a validação completa de mensagens SOAP não é necessária, mas você pode alterar isso no editor de recursos ou no CICS depois que o recurso tiver sido instalado.
    5. Depois de ter criado uma definição WEBSERVICE, você pode clicar nela com o botão direito do mouse e ativar um assistente para gerar as definições URIMAP para o serviço da web e criar uma transação de alias:
      • O caminho para o URIMAP é pré-preenchido com base no arquivo de ligação de serviço da web, mas você pode inserir um caminho diferente, se necessário.
      • O nome do host e o número da porta para o URIMAP são pré-preenchidos com base no arquivo de ligação de serviço da web. Se o nome do host não puder ser recuperado, o CICS Explorer exibirá uma mensagem de aviso e você deverá inserir um valor no campo Host. Se o número da porta não puder ser recuperado, o CICS Explorer fornecerá um valor padrão de 80 ou 443, dependendo do esquema de URI.
      • A transação de alias padrão é CPIH, mas você pode alterar isso e pode marcar a caixa de seleção para gerar uma definição de transação. Observe que as definições de transação não serão geradas para CPIH ou CPIQ, mesmo que a caixa de seleção seja marcada. Outros nomes de transação que começam com C são reservados para CICS.
      • Para fazer do recurso URIMAP um ponto de entrada do aplicativo, você pode abrir o CICS Bundle Manifest Editor e alternar para a guia Pontos de Entrada e, em seguida, incluir um ponto de entrada especificando um nome de operação exclusivo, tipo de recurso URIMAP e nome de recurso URIMAP.
    6. Para um recurso URIMAP, você pode criar um arquivo de configuração URIMAP pelo diálogo Nova Definição de Mapa de URI. Especifique o host, o caminho e escolha o uso.
      • Para uma definição de URIMAP que usa um arquivo HFS para fornecer uma resposta estática, o arquivo deve ser empacotado no pacote configurável do CICS com o recurso URIMAP. Especifique um caminho de arquivo relativo que seja relativo ao diretório raiz do pacote configurável do CICS. Para um caminho de arquivo relativo, não use uma barra no início do caminho. Caminhos absolutos podem ser usados, mas isso não é nada recomendado.
      • Selecione o uso:
        • Para criar uma definição de URIMAP para CICS como um servidor HTTP, selecione Servidor. Esse tipo de definição de URIMAP é usado para mapear o URI de uma solicitação HTTP recebida de um Web client para recursos do CICS. Uma resposta gerada pelo aplicativo ou uma resposta estática pode ser fornecida.
        • Para criar uma definição de URIMAP para CICS como um cliente HTTP, selecione Cliente. Esse tipo de definição de URIMAP é usado quando o CICS faz uma solicitação para um recurso HTTP em um servidor, para que você possa evitar a identificação do URI em seu programa de aplicativo.
        • Para criar uma definição de URIMAP para um serviço da web, selecione Pipeline. Esse tipo de definição de URIMAP é usado para uma solicitação de serviço da web de entrada; ou seja, uma solicitação pela qual um cliente chama um serviço da web no CICS. O URI da solicitação recebida é associado aos recursos WEBSERVICE e PIPELINE, que especificam o processamento que deve ser executado na mensagem.
        • Para criar uma definição de URIMAP para um feed Atom, selecione Atom. Esse tipo de definição de URIMAP é usado para uma solicitação recebida para dados que o CICS torna disponíveis como um feed Atom. A definição de URIMAP mapeia o URI de solicitação para uma definição de recurso ATOMSERVICE, que define um documento Atom.
        • Para criar um URIMAP para um aplicativo da web que está em execução em um servidor JVM, selecione Servidor JVM. Esse tipo de URIMAP é usado para mapear solicitações de aplicativos recebidas para uma transação do CICS. Se nenhum URIMAP corresponder ao URI da solicitação recebida, o CICS usará a transação CJSA.
        • Para configurar o URIMAP para que uma resposta estática seja fornecida, selecione Arquivo e, em seguida, selecione Arquivo HFS ou Nome do Modelo. O atributo de uso é configurado como USAGE(SERVER).
      • Para fazer do recurso URIMAP um ponto de entrada do aplicativo, marque a caixa de seleção Criar um ponto de entrada do aplicativo e insira um nome de operação exclusivo. Como alternativa, você pode abrir o CICS Bundle Manifest Editor e alternar para a guia Pontos de Entrada e, em seguida, incluir um ponto de entrada especificando um nome de operação exclusivo, tipo de recurso URIMAP e nome de recurso URIMAP.
  4. Clique em Concluir.
  5. Se desejar visualizar e editar os atributos para o recurso imediatamente após criá-lo, selecione a caixa de seleção Abrir Editor para abrir o editor de recursos quando tiver concluído o assistente. Se desejar fazer isso posteriormente, será possível abrir o editor de recursos a partir da visualização Explorador de Projetos.

Resultados

Uma definição de recurso é criada no projeto de pacote configurável do CICS e o manifesto do pacote configurável é atualizado.

O que Fazer Depois

Para editar o recurso no editor de recursos, siga as instruções em Editando Recursos Definidos em um Projeto de Pacote Configurável do CICS.

Quando tiver concluído sua definição de recurso, será possível implementar o projeto de pacote configurável do CICS no zFS ou empacotar o pacote configurável para implementação com um pacote configurável de aplicativo ou de plataforma. Consulte Implementando um Pacote Configurável do CICS para obter informações adicionais.