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 pacote configurável de aplicativo que a inclua, em 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 e aos pacotes configuráveis de gerenciamento 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 referenciado por um pacote configurável de aplicativo, você também deverá 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 referenciado por um pacote configurável de aplicativo, atualize o pacote configurável do aplicativo e a ligação de aplicativos. Atualizando Aplicativos explica como usar o editor de aplicativos e o editor de ligação de aplicativos para atualizar um pacote configurável de aplicativo e uma ligação de aplicativos.
    1. Atualize o pacote configurável do 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 uma ligação de aplicativos, atualize o arquivo bundles.xml para a ligação de aplicativos especificar a nova versão do pacote configurável do CICS e atualize o arquivo deployment.xml para que a ligação de aplicativos especifique os tipos de regiões onde a nova versão do pacote configurável do CICS está 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 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 pacote configurável do 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 o pacote configurável do CICS não for referenciado por um pacote configurável de aplicativo:
    1. 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.
  9. Se o pacote configurável do CICS for referenciado por um pacote configurável do aplicativo, siga o processo em Atualizando Aplicativos para desativar e descartar o recurso APPLCTIN instalado, criar uma nova definição de recurso APPLDEF e instalar a nova definição de recurso APPLDEF.

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.