Implementando novas versões de aplicativos em uma plataforma

Use o assistente de exportação par implementar o aplicativo atualizado e a ligação de aplicativos para o diretório inicial da plataforma no z/OS UNIX e use uma definição de recurso APPLDEF para instalá-los na plataforma.

Sobre Esta Tarefa

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

Se seu aplicativo usar apenas esses recursos, 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. Alternativamente, antes de exportar o aplicativo, edite-o para renomear os recursos que não são suportados para versões múltiplas, de forma que eles não entrem em conflito com os recursos instalados para versões anteriores do aplicativo.

Procedimento

  1. Exporte a nova versão do aplicativo e da ligação de aplicativos para o diretório inicial da plataforma no z/OS UNIX.
    • Para abrir o assistente de exportação, na visualização Explorador de Projetos, clique com o botão direito do mouse no projeto do Aplicativo ou no Projeto de Ligação de Aplicativos e clique em Exportar Projeto do Aplicativo para o Sistema de Arquivos do z/OS UNIX ou Exportar Projeto de Ligação de Aplicativos para o Sistema de Arquivos do z/OS UNIX.
    • Como alternativa, abra o aplicativo ou a ligação de aplicativos no editor de aplicativos ou no editor de ligação de aplicativos e clique em Assistente de Exportação na lista Ações.
    O número da nova versão para o aplicativo é usado como parte do nome para o diretório, portanto, as versões anteriores do aplicativo permanecem no diretório inicial da plataforma. Nenhum dos pacotes configuráveis do CICS para os quais você não incrementou o número da versão, que já estão implementados no diretório inicial da plataforma e instalados no CICSplex na versão correta é incluído na exportação. Consulte Implementando um Projeto do Aplicativo CICS para obter ajuda com a exportação do aplicativo.
  2. Crie uma nova definição de recurso APPLDEF com um novo número de versão para apontar para o diretório do aplicativo para a nova versão do aplicativo. Uma definição de recurso APPLDEF instalada representa uma única versão do aplicativo e ele não pode ser editado. Crie um APPLDEF separado para gerenciar cada versão do aplicativo.
    • 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.
    • Como alternativa, na visualização Cloud Explorer, clique com o botão direito do mouse e selecione Novo > Definição do Aplicativo para abrir o assistente Nova Definição do Aplicativo.
    Use o mesmo nome que você usou para as definições de recurso APPLDEF existentes para o aplicativo. Especifique um novo número de versão para o APPLDEF que corresponde ao novo número de versão para o projeto do aplicativo, como 1.1.0. Consulte Implementando um Projeto de Plataforma do CICS para ajudar na criação de uma nova definição de aplicativo.
  3. Se seu aplicativo usar recursos que não são suportados para várias versões, desative e descarte o recurso APPLCTN instalado que representa a versão anterior do aplicativo. Se o seu aplicativo usa somente recursos que são suportados como parte de aplicativos com diversas versões, ou você tiver renomeado todos os recursos que não são suportados para diversas versões, não é necessário desativá-lo, portanto, ignore esta etapa para evitar uma interrupção no serviço para os usuários.
    1. Na perspectiva CICS Cloud, na visualização Cloud Explorer, localize a versão relevante do aplicativo instalado na hierarquia de Plataforma ou na hierarquia do Aplicativo. Clique com o botão direito do mouse no nome do aplicativo e clique em Tornar Indisponível e, em seguida, em OK para tornar o aplicativo indisponível. Agora, o aplicativo não está mais disponível para os responsáveis pela chamada por meio de seus pontos de entrada do aplicativo.
    2. Dê um clique duplo no nome do aplicativo para abrir a versão do aplicativo instalado no editor de aplicativos online. Na guia Visão Geral, selecione a ação Desativar e descartar do botão Desativar. O CICSPlex SM desativa e descarta os pacotes configuráveis do CICS para a versão do aplicativo nas regiões do CICS e desinstala a versão do aplicativo da plataforma. Como alternativa, você pode desativar e descartar a versão do aplicativo na visualização Cloud Explorer da seguinte forma:
      • Clique com o botão direito do mouse no nome do aplicativo na visualização Cloud Explorer, selecione Desativar e, em seguida, clique em OK para confirmar.
      • Atualize a visualização Cloud Explorer e verifique o status do aplicativo para confirmar que o aplicativo está desativado. Se o aplicativo não estiver desativado, consulte Verificando o Status de um Aplicativo para obter mais informações e ações sugeridas.
      • Quando o aplicativo estiver desativado, clique com o botão direito do mouse no nome do aplicativo, selecione Descartar e, em seguida, clique em OK para confirmar.
    3. Atualize a visualização Cloud Explorer e verifique se, no lugar do nome do aplicativo, você vê o nome e o número da versão da definição do aplicativo (recurso APPLDEF) para a versão do aplicativo que você acabou de descartar. Se o CICSPlex SM não desativa ou descarta nenhum dos pacotes configuráveis, o aplicativo não é descartado. Nesta situação, consulte Verificando o Status de um Aplicativo para obter mais informações e ações sugeridas.
  4. Instale a nova definição de recurso APPLDEF para a nova versão do aplicativo, ative a versão do aplicativo e verifique a instalação.
    1. Na visualização Cloud Explorer, localize a definição do aplicativo com o número correto da nova versão na hierarquia da Plataforma ou na hierarquia do Aplicativo.
    2. Clique com o botão direito do mouse na nova definição do aplicativo, selecione Instalar e, em seguida, clique em OK para confirmar. O CICSPlex SM cria o novo recurso APPLCTN para representar a nova versão do aplicativo no CICSplex e instala os pacotes configuráveis do CICS nas regiões na plataforma. Os recursos que são definidos dentro dos pacotes configuráveis do CICS são criados dinamicamente nas regiões do CICS. Na visualização Cloud Explorer, o nome do aplicativo substitui o nome APPLDEF.
    3. Clique com o botão direito do mouse no nome do aplicativo, selecione Ativar e, em seguida, clique em OK para confirmar. Como alternativa, abra o aplicativo no editor de aplicativos online e clique no botão Ativar na guia Visão Geral. O CICSPlex SM ativa os pacotes configuráveis do CICS nas regiões do CICS na plataforma, mas a versão do aplicativo ainda não está disponível para os responsáveis pela chamada por meio de seus pontos de entrada do aplicativo.
    4. Atualize a visualização Cloud Explorer e verifique o status do aplicativo. Se o status não tiver sido alterado para ENABLED, siga o procedimento de resolução de problemas no Diagnosticando Erros de Aplicativo.
  5. Para disponibilizar a nova versão do aplicativo para os usuários da plataforma, na visualização Cloud Explorer, clique com o botão direito do mouse no nome do aplicativo, clique em Disponibilizar e, em seguida, em OK para disponibilizar a versão do aplicativo. Como alternativa, abra o aplicativo no editor de aplicativos online e clique no botão Disponibilizar na guia Visão Geral. A versão do aplicativo está, agora, disponível para os responsáveis pela chamada por meio de seus pontos de entrada do aplicativo, que podem ser recursos PROGRAM ou URIMAP.

Resultados

A nova versão do aplicativo é, agora, implementada na plataforma. Para aplicativos que são suportados para várias versões, se várias versões estiverem disponíveis, os responsáveis pela chamada poderão acessar a versão do aplicativo disponível mais alta ou usar o comando EXEC CICS INVOKE APPLICATION para especificar qualquer versão do aplicativo disponível. Para obter mais informações sobre como chamar uma versão específica de um aplicativo, consulte Chamando um aplicativo com várias versões no CICS TS V5.2 - informações do produto.

O que Fazer Depois

Para aplicativos que são suportados para várias versões, para remover temporária ou permanentemente quaisquer versões anteriores não desejadas de um aplicativo de uma plataforma, siga o procedimento em Tornando indisponíveis, desativando e descartando aplicativos.