Atualizando Aplicativos

Ao fazer mudanças nos pacotes configuráveis do CICS para os componentes de um aplicativo, atualize as versões dos pacotes configuráveis do CICS, o pacote configurável do aplicativo e a ligação de aplicativos e implemente as novas versões na plataforma.

Antes de Iniciar

Quando você atualiza um aplicativo que está implementado em uma plataforma, o aplicativo fica indisponível para os usuários do momento em que você desativa e descarta o recurso APPLCTN instalado no CICSplex para a versão anterior do aplicativo até o momento da instalação da nova definição de recurso APPLDEF e da ativação da nova versão do aplicativo. Planeje o momento adequado para que essa ação ocorra com segurança ou planeje uma solução alternativa para os usuários do aplicativo durante esse período.

Para atualizar um aplicativo, você precisa editar o projeto do aplicativo e o projeto de ligação de aplicativos. Caso não tenha um sistema de backup com versão que lhe permita reverter para uma versão anterior dos projetos, em vez de editar os projetos existentes diretamente conforme descrito nestas instruções, talvez você prefira copiá-los em outro projeto e depois editar as novas cópias.

Sobre Esta Tarefa

Você gerencia as mudanças nos aplicativos usando controle de versão. Cada pacote configurável do CICS, pacote configurável de aplicativo e ligação de aplicativos tem um ID e informações de versão para identificá-lo exclusivamente. 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.

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. Não é possível usar uma versão existente de um pacote configurável de aplicativo para instalar novas versões dos pacotes configuráveis do CICS para o aplicativo e nem usar uma versão existente de uma ligação de aplicativos com uma versão nova de um pacote configurável de aplicativo. Você deve atualizar o pacote configurável do aplicativo e a ligação de aplicativos sempre que atualizar os pacotes configuráveis do CICS para o aplicativo.

Quando você altera a versão de um pacote configurável de gerenciamento, de acordo com os princípios de versão semântica, a nova versão deve refletir a maior mudança em um pacote configurável do CICS que esteja incluído no pacote configurável de gerenciamento. Por exemplo, você pode alterar um pacote configurável do CICS para um aplicativo da Versão 1.0.1 para a Versão 1.0.2, que é uma mudança de versão micro, e alterar outro pacote configurável do CICS para o aplicativo da Versão 1.2.0 para a Versão 1.3.0, que é uma mudança de versão secundária. O pacote configurável do aplicativo que inclui esses dois pacotes configuráveis do CICS deve, portanto, ter uma mudança de versão secundária, de modo que se o pacote configurável do aplicativo estava antes na Versão 2.5.1, ele mude para a Versão 2.6.0.

Procedimento

  1. Clique em Janela > Mostrar Visualização > Explorador de Projetos para abrir a visualização Explorador de Projetos.
  2. Localize o projeto do aplicativo, expanda a pasta META-INF para o projeto do aplicativo e clique duas vezes no arquivo application.xml ou arquivo bundles.xml. O editor de aplicativos é aberto. Para um guia ao uso do editor de aplicativos, consulte O Editor de Aplicativos.
    Dica: Se o CICS Explorer localizar um erro nos arquivos XML para o pacote configurável do aplicativo, ou outro problema importante, as informações sobre o erro ou problema serão exibidas na visualização Problemas.
  3. Para incluir mais pacotes configuráveis do CICS no pacote configurável do aplicativo, clique em Incluir. Selecione os pacotes configuráveis do CICS apropriados na lista de pacotes configuráveis do CICS que estão disponíveis em sua área de trabalho.
  4. Para remover os pacotes configuráveis do CICS que estão atualmente incluídos no pacote configurável do aplicativo, selecione os pacotes configuráveis do CICS e clique em Remover.
  5. Para editar qualquer um dos pacotes configuráveis do CICS incluídos no pacote configurável do aplicativo, clique duplo no nome do pacote configurável do CICS na lista, no editor de aplicativos, para abrir o editor de manifesto do pacote configurável.
    1. Use 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.
    2. 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.
    3. Quando você tiver atualizado um 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.
    4. Remova a versão antiga do pacote configurável do CICS do pacote configurável do aplicativo selecionando-a e clicando em Remover no editor de aplicativos. Quando você atualiza o número da versão para o pacote configurável do CICS, o CICS Explorer marca a versão antiga com um erro no editor de aplicativos.
    5. Inclua o pacote configurável do CICS atualizado no pacote configurável do aplicativo clicando em Incluir no editor de aplicativos e selecionando a nova versão do pacote configurável do CICS da lista de pacotes configuráveis do CICS que estão disponíveis em sua área de trabalho.
  6. Para editar qualquer um dos pontos de entrada do aplicativo, clique duplo no nome do ponto de entrada do aplicativo na lista, no editor de aplicativos, para abrir o editor de manifesto do pacote configurável. Quando tiver atualizado o ponto de entrada do aplicativo, 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 a política de designação de versão e salve suas mudanças. Inclua o pacote configurável do CICS atualizado contendo o ponto de entrada do aplicativo no pacote configurável do aplicativo e remova a versão antiga.
  7. Quando tiver concluído suas atualizações no aplicativo, use o campo Versão no editor de aplicativos para incrementar os números da versão principal, secundária ou micro para o aplicativo de acordo com sua política de designação de versão e salve suas mudanças.
  8. Em seguida, é possível atualizar a ligação de aplicativos existente para especificar a nova versão do aplicativo ou criar uma nova ligação de aplicativos para a nova versão do aplicativo.
    • Para criar uma nova ligação de aplicativos para a nova versão do aplicativo, clique em Criar uma Ligação de Aplicativos no editor de aplicativos para abrir o assistente de ligação de aplicativos e siga as etapas no assistente.
    • Para atualizar a ligação de aplicativos existente, na visualização Explorador de Projetos, localize a ligação de aplicativos existente para o aplicativo, expanda a pasta META-INF para o projeto da ligação de aplicativos e dê um clique duplo no arquivo application.xml, bundles.xml ou deployment.xml. O editor de ligação de aplicativos é aberto. Para um guia ao uso do editor de ligação de aplicativos, consulte O Editor de Ligação de Aplicativos.
  9. No editor de ligação de aplicativos, clique em Navegar pelo nome do aplicativo e selecione a nova versão do aplicativo.
  10. Execute algumas mudanças que você requer aos pacotes configuráveis do CICS que são implementados com a ligação de aplicativos.
    1. Clique em Incluir ou Remover para alterar a seleção de pacotes configuráveis do CICS que são implementados na ligação do aplicativo.
    2. Dê um clique duplo em qualquer pacote configurável do CICS para editá-lo. Atualize e reverta os pacotes configuráveis do CICS e inclua as novas versões na ligação de aplicativos da maneira descrita em 5 para os pacotes configuráveis do CICS para o aplicativo.
  11. Para editar qualquer uma das políticas implementadas com a ligação de aplicativos, clique duplo no nome da política na lista, no editor de aplicativos, para abrir o editor do manifesto do pacote configurável. Quando tiver atualizado a política, 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 a política de designação de versão e salve suas mudanças. Inclua o pacote configurável do CICS atualizado contendo a política na ligação de aplicativos e remova a versão antiga.
  12. Na guia Implementar do editor de ligação de aplicativos, verifique que cada um dos pacotes configuráveis doCICS para o aplicativo, e cada um dos pacotes configuráveis do CICS com a ligação de aplicativo está ligado a um tipo de região adequada. Use o botão do comutador O botão do comutador para alternar entre trabalhar com tipos de região e trabalhar com pacotes configuráveis do CICS.
    1. Todo pacote configurável do CICS que ainda não estiver ligado a nenhum tipo de região será marcado com a letra X. Trabalhando com os pacotes configuráveis do CICS, selecione cada novo pacote configurável do CICS e use as caixas de opção para especificar os tipos de região em que ele deve ser implementado.
    2. Quaisquer tipos de região especificadas na ligação de aplicativos, mas que não podem ser encontradas na versão atual do projeto da plataforma associada à ligação de aplicativo, são marcadas com um ponto de exclamação. Verifique se você está trabalhando com a versão correta do projeto de plataforma. Se você tiver removido o tipo de região da plataforma, ou mudado para uma plataforma que não inclua o tipo de região, limpe o projeto de ligação de aplicativos. Trabalhando com os tipos de região, selecione cada tipo de região indesejado e desmarque todos os pacotes configuráveis do CICS especificados para esse tipo de região.
  13. Quando tiver concluído suas atualizações na ligação de aplicativos, use o campo Versão no editor de ligação de aplicativos para incrementar os números da versão principal, secundária ou micro para a ligação de aplicativos de acordo com sua política de designação de versão e salve suas mudanças.
    Dica: O número da versão para a ligação de aplicativos não precisa ser igual ao número da versão do aplicativo. No entanto, de acordo com os princípios de versão semântica, você deve atualizar o número da versão para a ligação de aplicativos para refletir a maior mudança no aplicativo ou nos pacotes configuráveis do CICS implementados com a ligação de aplicativos.
  14. Clique em Assistente de Exportação no editor de aplicativos ou no editor de ligação de aplicativos para implementar a ligação de aplicativos ou o aplicativo atualizado no diretório inicial da plataforma no z/OS UNIX. O número da nova versão é usado como parte do nome do diretório, portanto, versões anteriores do aplicativo e pacote configurável do aplicativo permanecem no diretório inicial da plataforma.
  15. Crie uma nova definição de recurso APPLDEF para apontar para o diretório de aplicativo atualizado. Para criar uma definição de recurso APPLDEF durante o processo de exportação, selecione a caixa de seleção no assistente de exportação.
  16. Desative e descarte o recurso APPLCTN instalado que representa a versão anterior do aplicativo.
  17. Instale a nova definição de recurso APPLDEF.

Resultados

A nova versão do aplicativo é implementada na plataforma. Os pacotes configuráveis do CICS que estão incluídos na nova versão do pacote configurável do aplicativo são instalados nas regiões apropriadas do CICS, e os recursos definidos dentro dos pacotes configuráveis do CICS são criados dinamicamente nas regiões do CICS.