Definindo Dependências de Pacote Configurável

Defina as dependências ou importações para um pacote configurável do CICS nos elementos <import> no arquivo de manifesto do pacote configurável (cics.xml).

Sobre Esta Tarefa

Se precisar que um recurso do CICS esteja disponível na região do CICS, mas não quiser que o ciclo de vida do recurso seja ligado ao ciclo de vida do pacote configurável do CICS, você poderá incluir o recurso como uma dependência para o pacote configurável do CICS. Por exemplo, se o pacote configurável do CICS contiver recursos para um serviço da web, você poderá especificar que o recurso PIPELINE usado pelo serviço da web esteja disponível na região do CICS. Quando você instala o pacote configurável do CICS, o CICS verifica se um recurso do tipo especificado com o nome especificado seja instalado e ativado na região do CICS.

Você pode selecionar a ação que o CICS executará se um recurso especificado em um elemento <import> não estiver presente na região do CICS. Por exemplo, a instalação do pacote configurável pode falhar ou ser bem-sucedida, mas com uma mensagem de aviso. É possível tornar as importações opcionais, para que o recurso BUNDLE sempre seja instalado em um estado ativado, mesmo que a dependência não seja atendida.

Em um pacote configurável do CICS que é empacotado como parte de um aplicativo implementado em uma plataforma, recursos públicos ou privados podem ser definidos como dependências, incluindo programas privados que são instalados automaticamente por um aplicativo. O CICS verifica primeiro um recurso privado com o tipo e o nome especificados no mesmo aplicativo que o pacote configurável do CICS que contém o elemento <import> no arquivo de manifesto do pacote configurável. Se mais de uma versão do aplicativo for instalada, o contexto de aplicativos atual determinará a versão do recurso privado que é importada. Se o recurso não for localizado como um recurso privado para o aplicativo, o CICS verificará um recurso público na região do CICS que corresponda ao tipo e nome especificados e importará esse recurso. Não é possível importar recursos privados de outros aplicativos.

Procedimento

  1. Navegue para a pasta META-INF do pacote configurável com o qual você deseja trabalhar.
  2. Clique duas vezes no arquivo de manifesto cics.xml. O editor de Manifesto do Pacote Configurável abre e exibe todos os recursos atuais que são necessários para este pacote configurável e o ID e a versão do pacote configurável.
  3. Clique em Incluir. O diálogo de propriedades de importação se abre.
  4. Insira o tipo de recurso na lista de tipos de recursos do CICS. É possível pressionar Ctrl + Espaço para exibir a assistência de conteúdo.
  5. Insira o nome do recurso requerido.
  6. Selecione se a importação é necessária ou opcional antes da ativação do recurso BUNDLE. O comportamento padrão é que a importação seja necessária e o recurso BUNDLE não possa ser ativado até que a dependência seja atendida. Se você selecionar Opcional, o recurso BUNDLE será instalado mesmo que a dependência não seja atendida na região do CICS. Escolha se uma mensagem de aviso será emitida ou não se a dependência não for atendida.
  7. Clique em OK. O recurso é incluído na lista de recursos importados que são requeridos por esse pacote configurável.
  8. Clique em Salvar.

Resultados

Você definiu os recursos do CICS que são requeridos pelo pacote configurável do CICS.

O que Fazer Depois

É possível incluir recursos do CICS no projeto de Pacote configurável. Esses recursos são criados dinamicamente quando o recurso BUNDLE é instalado na região CICS.