Atualizando Pacotes Configuráveis do CICS

Use o editor de manifesto do pacote configurável e os editores de recurso para editar o conteúdo de um pacote configurável do CICS para aumentar seu número de versão. Em seguida, implemente a nova versão do pacote configurável do CICS, ou um aplicativo que o inclua, para suas regiões do CICS.

Sobre Esta Tarefa

Você gerencia mudanças nos pacotes configuráveis do CICS usando o controle de versão. Você deve aplicar uma política de designação de versão aos seus pacotes configuráveis do CICS, aos pacotes configuráveis do aplicativo e às ligações de aplicativos para implementar e gerenciar atualizações no ambiente do CICS.

Cada pacote configurável tem um ID e informações da versão exclusivamente para identificá-lo. A versão usa os identificadores principal, secundário e micro, portanto, é possível indicar a significância de uma mudança e gerenciar dependências entre os pacotes configuráveis. Esse conceito é chamado versão semântica e é obtido do OSGi Alliance. Embora seu foco sejam pacotes Java™, é possível usar os mesmos princípios para aplicar os pacotes configuráveis em geral.

A versão semântica fornece uma maneira de incrementar as partes principal, secundária ou micro de uma versão para indicar a compatibilidade ou a incompatibilidade com versões anteriores de um pacote configurável. Por exemplo, correções de bug podem incrementar a parte micro da versão, as mudanças compatíveis incrementam a parte secundária da versão e mudanças incompatíveis incrementam a parte principal da versão. Para obter mais informações sobre versão semântica, consulte White Paper Técnico sobre Versão Semântica.

É possível especificar que um pacote configurável do CICS mudou aumentando o número da versão no arquivo de manifesto do pacote configurável. Se o pacote configurável do CICS for referido por um aplicativo, você deverá também aumentar a versão do pacote configurável do aplicativo para reimplementação.

Procedimento

  1. Clique em Janela > Mostrar Visualização > Explorador de Projetos para abrir a visualização Explorador de Projetos.
  2. Para editar um pacote configurável do CICS, expanda a pasta META-INF para o pacote configurável do CICS e dê um clique duplo no arquivo cics.xml. O editor de manifesto do pacote configurável é aberto.
  3. Atualize o pacote configurável do CICS conforme necessário. É possível usar o editor de manifesto do pacote configurável para incluir e remover dependências do pacote configurável do CICS, criar novos pontos de entrada do aplicativo e definir escopos de política. Para editar recursos que estão definidos no pacote configurável do CICS, use os editores de recurso conforme descrito em Editando Recursos Definidos em um Projeto de Pacote Configurável do CICS.
  4. Quando você tiver atualizado o pacote configurável do CICS, use o editor de manifesto do pacote configurável para incrementar os números da versão principal, secundária ou micro para o pacote configurável do CICS de acordo com sua política de designação de versão e salve suas mudanças.
  5. Se o pacote configurável do CICS for referido por um aplicativo, atualize o aplicativo e a ligação de aplicativos. O Atualizando Aplicativos explica como usar o editor de aplicativos e o editor de ligação de aplicativos para atualizar um aplicativo e uma ligação de aplicativos.
    1. Atualize o aplicativo com a nova versão do pacote configurável do CICS no arquivo bundles.xml para o pacote configurável do aplicativo.
    2. Incremente os números da versão principal, secundária ou micro para o aplicativo no arquivo application.xml para o pacote configurável do aplicativo.
    3. Incremente os números da versão principal, secundária e micro para o aplicativo no arquivo appbinding.xml para a ligação de aplicativos.
    4. Incremente os números da versão principal, secundária e micro para a ligação de aplicativos no arquivo appbinding.xml para a ligação de aplicativos.
  6. Se o pacote configurável do CICS for implementado com um aplicativo ou uma ligação de aplicativos, atualize o arquivo bundles.xml para a ligação de aplicativos para especificar a nova versão do pacote configurável do CICS e atualize o arquivo deployment.xml para a ligação de aplicativos para especificar os tipos de região nos quais a nova versão do pacote configurável do CICS é implementada. Incremente o número da versão para a ligação de aplicativos no arquivo appbinding.xml para a ligação de aplicativos. Atualizando um projeto de ligação de aplicativos explica como usar o editor de ligação de aplicativos para atualizar uma ligação de aplicativos.
  7. Reimplemente o pacote configurável do CICS ou o aplicativo e a ligação de aplicativos que o inclui exportando o projeto para o z/OS UNIX. O número da nova versão é usado como parte do nome do diretório do pacote configurável, portanto, as versões anteriores do pacote configurável permanecem no z/OS UNIX.
  8. Se a versão anterior do pacote configurável do CICS foi instalada em uma ou mais regiões do CICS como um pacote configurável do CICS independente, atualize o pacote configurável do CICS em cada região do CICS individualmente.
    1. Torne indisponível, desative e descarte o recurso BUNDLE instalado que representa a versão anterior do pacote configurável do CICS.
    2. Edite a definição de recurso BUNDLE para apontar para o diretório do pacote configurável atualizado.
    3. Reinstale a definição de recurso BUNDLE, ative-a e disponibilize-a.
  9. Se a versão anterior do pacote configurável do CICS foi implementada com um pacote configurável de plataforma ou incluída em uma plataforma, atualize o pacote configurável do CICS no nível da plataforma.
    1. Desative a versão anterior do pacote configurável do CICS e remova-o da plataforma, seguindo as instruções em Removendo um Pacote Configurável do CICS de uma Plataforma.
    2. Inclua a nova versão do pacote configurável do CICS na plataforma e ative-a, seguindo as instruções em Incluindo um pacote configurável do CICS em uma plataforma.
  10. Se o pacote configurável do CICS for referido por um pacote configurável do aplicativo, siga o processo em Implementando novas versões de aplicativos em uma plataforma para tornar indisponível, desativar e descartar o recurso APPLCTN instalado, criar uma nova definição de recurso APPLDEF e instalar a nova definição de recurso APPLDEF. Se seu aplicativo usar apenas os recursos que são suportados para várias versões, você poderá instalar e disponibilizar várias versões do aplicativo ao mesmo tempo na plataforma. Se seu aplicativo utilizar recursos que não são suportados para diversas versões, é necessário desativar e descartar a versão existente do aplicativo antes de instalar uma nova versão.

Resultados

O pacote configurável do CICS é instalado nas regiões apropriadas do CICS, e os recursos que são definidos dentro do pacote configurável são criados dinamicamente nas regiões do CICS.