Se uma versão do aplicativo que é implementado em uma plataforma não tiver o status esperado, siga este procedimento de resolução de problemas para executar a ação apropriada.
Antes de Iniciar
Use a visualização Cloud Explorer na perspectiva CICS Cloud para verificar o status da
versão do aplicativo. O
Verificando o Status de um Aplicativo explica como usar a visualização e lista os valores possíveis
para o status de uma versão do aplicativo e das partes de gerenciamento. Uma versão do aplicativo será ativada se os pacotes configuráveis do CICS referenciados pelas partes de gerenciamento para a versão do aplicativo tiverem sido instalados nas regiões do CICS e todos eles estiverem ativados. Nas regiões do CICS do CICS TS 5.2, uma versão do aplicativo ativado
ainda não está disponível para os responsáveis pela chamada por meio de seus pontos de entrada do aplicativo. Quando a versão do aplicativo for disponibilizada, os pontos de entrada do
aplicativo e, portanto, os recursos que eles controlam para o aplicativo,
estarão disponíveis para os responsáveis pela chamada.
Procedimento
- Se o status de uma versão do aplicativo for FAILED, verifique o
log de saída do CICSPlex SM
(o EYULOG) para obter detalhes do problema que ocorreu enquanto o aplicativo
estava sendo instalado ou descartado. O repositório de dados CICSPlex
SM para CMAS pode estar cheio, em cujo caso você precisará aumentar seu tamanho. Para expandir o repositório de dados, use a função REPRO do utilitário IDCAMS. Um exemplo de JCL para isso está no membro EYUJXDRP
da biblioteca CICSTS51.CPSM.SEYUSAMP. Nessa JCL, na instrução RECORDS(xx,yy), especifique um valor primário
(xx) e um secundário (yy) que sejam apropriados para seu ambiente. Os valores iniciais
são 500 e 3000.
- Se o status de uma versão do aplicativo for DISABLED ou
SOMEDISABLED, tente ativar todo o aplicativo.
- Na visualização Cloud Explorer, clique com o botão direito do mouse na versão do
aplicativo e selecione Ativar. Se a versão do aplicativo estiver aberta
no editor de aplicativos online, use o botão
Ativar na guia Visão Geral. O CICSPlex SM tenta ativar todos os
pacotes configuráveis do CICS para a versão do aplicativo em todas as regiões do CICS.
- Verifique o novo status para ver se a versão do
aplicativo está ativada agora. Se a versão do aplicativo não estiver ativada,
investigue os pacotes configuráveis do CICS individuais que são nomeados em cada parte de gerenciamento. Na visualização do Cloud Explorer, use a lista suspensa alternar hierarquia
para alternar a hierarquia do aplicativo. Trabalhar com a hierarquia do aplicativo,
expande cada tipo de região exibida
no aplicativo para mostrar a lista Pacotes Configuráveis para o tipo de região. Expanda cada lista Pacotes Configuráveis para exibir
as partes de gerenciamento para o aplicativo.
- Se o status de uma parte do gerenciamento for DISABLED ou SOMEDISABLED, tente ativar os pacotes configuráveis individuais do CICS em cada região do CICS onde estão instalados.
- Dê um clique duplo na parte de gerenciamento para abrir a visualização Pacotes Configuráveis do CICS, que exibe os pacotes configuráveis instalados do CICS.
Alternativamente, clique com o botão direito do mouse na parte de gerenciamento e clique em Mostrar Pacotes Configuráveis
Instalados.
- Na visualização Pacotes Configuráveis do CICS, selecione o registro para o pacote configurável do
CICS na região do CICS em que deseja ativá-lo, clique com o botão direito do mouse e selecione Ativar.
- Se o pacote configurável do CICS permanecer desativado, verifique sua definição para saber se ele tem alguma dependência de importação para um recurso que não está presente na região do CICS.
Dica: Se um pacote configurável do CICS que contém a definição para um recurso LIBRARY
privado para um aplicativo estiver desativado, o CICS não tentará carregar módulos do programa
de qualquer outra concatenação LIBRARY privada para o aplicativo ou das
concatenações LIBRARY públicas na ordem de procura global. Em vez disso, uma resposta "não localizado" é retornada para a tarefa. Esta
ação evita a possibilidade de carregar o programa errado e permite o gerenciamento de
carga de trabalho para rotear o trabalho fora da região do CICS. Todos os pacotes configuráveis do CICS que contêm definições para recursos LIBRARY devem, portanto,
ser ativados para executar carregamentos de programas para o aplicativo.
- Se o status de uma versão do aplicativo for INCOMPLETE ou
EMPTY, investigue os pacotes configuráveis do CICS individuais que são nomeados em cada parte de gerenciamento:
- Na visualização do Cloud Explorer, use a lista suspensa alternar hierarquia
para alternar a hierarquia do aplicativo. Trabalhar com a hierarquia do aplicativo,
expande cada tipo de região exibida
no aplicativo para mostrar a lista Pacotes Configuráveis para o tipo de região.
Expanda cada lista Pacotes Configuráveis para exibir
as partes de gerenciamento para o aplicativo. Para trabalhar com os pacotes configuráveis do CICS instalados, dê um clique duplo na parte do gerenciamento para abrir a visualização Pacotes Configuráveis do CICS. Alternativamente, clique com o botão direito do mouse na parte de gerenciamento e clique em Mostrar Pacotes Configuráveis
Instalados.
- Se o status de uma parte de gerenciamento for INVALIDSCOPE, verifique
a definição para o pacote configurável do CICS
para ver se o grupo do sistema CICS
de destino foi especificado corretamente.
- Se o status de uma parte de gerenciamento for EMPTY, verifique se
as regiões do CICS onde o pacote
configurável do CICS deve estar instalado estão ativas e conectadas ao CMAS. Para verificar se as regiões do CICS
estão ativas, use a lista suspensa alternar hierarquia
para alternar a hierarquia
da plataforma na visualização do Cloud Explorer. Para a plataforma na qual o aplicativo está instalado, expanda os tipos de região e, em seguida, expanda a lista Regiões para cada tipo de região para mostrar as regiões do CICS e seus
status. Se as regiões do CICS estiverem disponíveis, verifique na definição para o pacote configurável do CICS a existência de erros.
- Se o status de uma parte de gerenciamento for INCOMPLETE, verifique o log do CICSMSG das regiões do CICS no tipo de região do pacote configurável afetado para obter mais informações sobre por que o pacote configurável não foi instalado. Se o pacote configurável do CICS não puder ser localizado, verifique sua configuração do zFS.
- Esse erro pode ocorrer quando uma plataforma é difundida para diferentes sistemas (LPARs) no mesmo sysplex, mas o diretório inicial da plataforma no sistema de arquivos zFS não é compartilhado no sysplex. Você deve usar FTP usando uma conexão com o mesmo zFS que seu CMAS está em execução ou configurar o configurar de sysplex de seu diretório inicial da plataforma.
- Este erro também pode ocorrer se o diretório inicial da plataforma estiver em um sysplex diferente do sysplex onde a plataforma está instalada.
Assegure-se de que o diretório inicial da plataforma esteja no mesmo sysplex que instalou a plataforma.
- Se você estiver enfrentando um problema com um recurso privado que
foi instalado em uma região do CICS para uma versão do aplicativo,
investigue os recursos privados individuais.
- Na visualização Cloud Explorer, clique duas vezes no nome da versão
do aplicativo instalado para abri-lo no editor de aplicativos online e
selecione a guia Recursos Privados. Para filtrar
os recursos privados pela região do CICS na qual eles estão instalados,
selecione a hierarquia de região na área de janela Estrutura. Como alternativa,
para filtrar os recursos privados pelo pacote configurável do CICS no qual eles são
definidos, selecione a hierarquia de pacotes configuráveis na área de janela Estrutura.
- Selecione a guia apropriada para o tipo de recurso para visualizar
os recursos privados instalados para o aplicativo. Verifique se
cada recurso privado esperado existe em todas as regiões do CICS apropriadas
e verifique o status e informações detalhadas para o recurso privado
para ver se há alguma anomalia. Para trabalhar com um recurso privado, clique duas vezes no nome do recurso para abri-lo em um editor.
- Se seu aplicativo tiver recursos LIBRARY privados, selecione a
guia Nomes DS da Biblioteca para visualizar o nome DD que o z/OS gerou
para cada concatenação LIBRARY de conjuntos de dados. Verifique se esses conjuntos de
dados foram criados corretamente.
- Se você executar a ação Disponibilizar para disponibilizar uma versão do aplicativo para os responsáveis pela chamada, mas
o status de disponibilidade não for exibido como AVAILABLE, primeiro verifique
se a ação foi requerida.
- Se o status de disponibilidade da versão do aplicativo não for realmente exibido,
isso será correto para as regiões do CICS que ainda estão no CICS TS 5.1. A ação Disponibilizar não se aplica a aplicativos
nessas regiões e eles estarão disponíveis para os responsáveis pela chamada assim que estiverem no status ENABLED.
- Se o status de disponibilidade da versão do aplicativo for
exibido como "Nenhum ponto de entrada" (que é o status NONE), o aplicativo não terá nenhum
ponto de entrada do aplicativo, portanto, a ação Disponibilizar não será requerida. Os pontos de entrada do aplicativo
são usados para controlar o acesso dos usuários a versões do aplicativo
em um ambiente com várias versões, portanto, você deve declarar os pontos de entrada do
aplicativo para os recursos PROGRAM ou URIMAP no aplicativo.
- Se você executar a ação Disponibilizar para disponibilizar uma versão do aplicativo para os responsáveis pela chamada e
a ação foi requerida, mas o status de disponibilidade da versão do aplicativo
permanecer como UNAVAILABLE ou SOMEAVAIL por um período estendido, investigue
as partes de gerenciamento individuais para a versão do aplicativo. Na visualização Cloud Explorer, trabalhando
com a hierarquia de aplicativos, expanda cada tipo de região exibido
no aplicativo para mostrar a lista Pacotes Configuráveis para o tipo de região. Expanda cada lista Pacotes Configuráveis para exibir
as partes de gerenciamento para o aplicativo.
- Se o status de disponibilidade de uma parte de gerenciamento é apresentado como "Nenhum ponto de entrada" (o que é o status NONE), o pacote configurável CICS não contém quaisquer instruções de pontos de entrada do aplicativo, de modo que você não precisa investigá-lo.
- Se o status de disponibilidade de uma parte de gerenciamento for exibido como
AVAILABLE, os pontos de entrada do aplicativo declarados no pacote configurável do CICS foram disponibilizados com êxito para os responsáveis pela chamada, portanto, você não precisará investigá-lo.
- Se o status de disponibilidade de uma parte de gerenciamento for exibido como
UNAVAILABLE ou SOMEAVAIL, verifique o status dos pacotes configuráveis do CICS individuais e as partes do pacote configurável, que representam os recursos instalados para um pacote configurável do CICS. Para trabalhar com os pacotes configuráveis do CICS instalados, dê um clique duplo na parte do gerenciamento para abrir a visualização Pacotes Configuráveis do CICS. Alternativamente, clique com o botão direito do mouse na parte de gerenciamento e clique em Mostrar Pacotes Configuráveis
Instalados. Para visualizar as partes do pacote configurável para os
recursos individuais que foram instalados para o pacote configurável do CICS, clique com o botão direito do mouse no nome do pacote configurável do CICS na visualização
Pacotes Configuráveis e clique em Mostrar Partes do Pacote Configurável. Verifique se qualquer uma das situações a seguir se aplica:
- Um ponto de entrada do aplicativo é declarado no pacote configurável do CICS com um nome de operação que duplica um nome de operação usado em qualquer outro lugar dentro do aplicativo. Para evitar
essa situação, certifique-se de que os nomes da operação sejam exclusivos dentro de um aplicativo.
Os nomes de operações fazem distinção entre maiúsculas e minúsculas, portanto, você pode usar os nomes de operações
que são diferenciados apenas por maiúsculas e minúsculas, como "procurar" e "Procurar".
- Um recurso URIMAP declarado no pacote configurável do CICS como um ponto de entrada do aplicativo
não existe ou já está reservado como um ponto de entrada do aplicativo para um
aplicativo diferente. Para evitar essas situações, defina o recurso
URIMAP com um nome exclusivo em seu ambiente.
- Um programa que é declarado no pacote configurável do CICS como um ponto de entrada do aplicativo é um programa privado definido em um dos pacotes configuráveis do CICS implementados
com a versão do aplicativo. No entanto, um programa com esse nome já está instalado
como um programa público na região do CICS. Os programas que são declarados como um
ponto de entrada do aplicativo devem ter um nome de recurso PROGRAM exclusivo em
seu ambiente. Para evitar essa situação, renomeie o programa privado
em sua definição de recurso e na declaração do ponto de entrada do aplicativo
para tornar seu nome exclusivo. Várias versões do mesmo recurso PROGRAM
privado definido como um ponto de entrada do aplicativo podem ser instaladas para
várias versões do mesmo aplicativo, porque o CICS gerencia a promoção
de recursos PROGRAM privados para o status púbico para as versões
de um aplicativo.
- Uma versão anterior do aplicativo declarada como um ponto de entrada do aplicativo,
um programa que não foi definido em um dos pacotes configuráveis do CICS implementados com a versão do aplicativo e que já foi instalado como um programa público. Quando a versão do aplicativo foi
ativada, o CICS reservou o programa público
instalado como um ponto de entrada do aplicativo. No entanto, o CICS não pode gerenciar automaticamente
os pontos de entrada do aplicativo para novas versões do aplicativo, pois um
programa público que foi instalado antes do aplicativo não pode se tornar
um programa privado. Para atualizar o aplicativo para uma nova versão,
você precisará desativar e descartar a versão existente.
Para evitar essa situação, você pode organizar que o programa público seja
instalado automaticamente pelo processo d instalação do aplicativo, caso em que
ele pode se tornar um programa privado e permitir que futuras versões do aplicativo
sejam instaladas ao mesmo tempo. Como alternativa, você pode definir o programa
em um dos pacotes configuráveis do CICS
implementados com a versão do aplicativo, assegurando que ele tenha um nome exclusivo
e, portanto, torne-se um programa privado.
- Se não for possível desativar uma versão do aplicativo,
verifique se a ação Tornar Indisponível foi executada
para a versão do aplicativo onde for necessário.
- Nas regiões do CICS do
CICS TS 5.2, se o status de disponibilidade
da versão do aplicativo for exibido como AVAILABLE, você deverá executar
a ação Tornar Indisponível para tornar a versão do
aplicativo indisponível para os responsáveis pela chamada antes de
desativá-lo.
- Se sua plataforma incluir todas as regiões do CICS que ainda estão no CICS TS 5.1, a ação Tornar Indisponível não se aplicará a aplicativos nessas regiões. Seu status de disponibilidade
não é exibido.
- Se qualquer um de seus aplicativos não tiver nenhum ponto de entrada do
aplicativo, a ação Tornar Indisponível não será necessária
para esses aplicativos. Seu status de disponibilidade é exibido
como "Nenhum ponto de entrada".
- Se seu aplicativo se tornou indisponível onde necessário
e você executou a ação Desativar, mas a versão do aplicativo permanece no estado DISABLING,
investigue os pacotes configuráveis do CICS individuais que são nomeados em cada parte de gerenciamento.
- Na visualização Cloud Explorer, trabalhando
com a hierarquia de aplicativos, expanda cada tipo de região exibido
no aplicativo para mostrar a lista Pacotes Configuráveis para o tipo de região. Expanda cada lista Pacotes Configuráveis para exibir
as partes de gerenciamento para o aplicativo. Para trabalhar com os pacotes configuráveis do CICS instalados, dê um clique duplo na parte do gerenciamento para abrir a visualização Pacotes Configuráveis do CICS. Alternativamente, clique com o botão direito do mouse na parte de gerenciamento e clique em Mostrar Pacotes Configuráveis
Instalados.
- Na visualização Pacotes Configuráveis do CICS,
localize qualquer pacote configurável do CICS que ainda
não esteja desativado. Selecione o registro para o pacote configurável do CICS na região do CICS em que ele ainda não esteja desativado, clique com o botão direito do mouse
e selecione Desativar.
- Se o pacote configurável do CICS ainda
não estiver desativado, visualize as partes do pacote configurável na visualização Partes do Pacote Configurável
para identificar e verificar o status dos recursos individuais que foram instalados
para o pacote configurável do CICS. Para visualizar as partes do pacote configurável, clique com o botão direito do mouse no nome do pacote configurável do CICS na visualização Pacotes Configuráveis e clique
em Mostrar Partes do Pacote Configurável.
- Verifique o status de qualquer recurso LIBRARY ou PROGRAM que está definido no
pacote configurável CICS. O recurso BUNDLEPART associado a um recurso LIBRARY não relata um
status de DISABLED até que a concatenação LIBRARY do programa dinâmico
e todos os programas carregados a partir dele tenham uma contagem de uso de
zero. Para um recurso PROGRAM, embora o CICS desative o programa quando a operação Desativar é executada no pacote configurável do CICS a partir do qual
ele foi instalado, o recurso BUNDLEPART associado permanece ativado
até que a contagem de uso para o programa atinja zero. Se a contagem de uso
não atingir zero depois de um intervalo aceitável, talvez seja necessário
o trabalho de limpeza do CICS para que
o processo de desativação do pacote configurável possa ser concluído.
- Verifique o status de qualquer recurso JVMSERVER ou TCPIPSERVICE que está definido no
pacote configurável CICS. Por padrão, esses recursos não são desativados até que todas as tarefas
atuais tenham terminado de usá-los.
- Para um recurso JVMSERVER, se você deseja desativar o servidor JVM
imediatamente e limpar as tarefas que estão em execução nele, use o comando SET
JVMSERVER PURGE, FORCEPURGE ou KILL no recurso gerado dinamicamente
na região do CICS.
Você pode executar essa ação no CICS Explorer.
- Para um recurso TCPIPSERVICE, se você deseja desativar o serviço
imediatamente e fechar todas as conexões, use o comando SET TCPIPSERVICE
IMMCLOSE no recurso gerado dinamicamente na região do CICS. Você pode executar essa
ação no CICS Explorer.
Você não pode usar esses métodos para desativar o recurso a menos que já tenha executado
a ação Desativar no pacote configurável do CICS.
- Verifique o status de qualquer recurso FILE que está definido no pacote configurável
CICS e verifique também o log de mensagens do CICS para a mensagem DFHFC6043. O CICS emite a mensagem quando você tentou desativar um arquivo definido em um pacote configurável CICS, mas o arquivo ainda está em uso ou há um bloqueio retido no arquivo.
- Se o arquivo estiver no estado DISABLED e o CICS
emitiu a mensagem DFHFC6043, para um arquivo recuperável, verifique e resolva
o bloqueio retido. Para um arquivo não recuperável, verifique as tarefas que estão usando o
arquivo, e limpe as tarefas ou dê tempo para que elas sejam concluídas. Quando o processo
apropriado é concluído, o pacote configurável do CICS
é movido para o estado DISABLED.
- Se o arquivo estiver no estado DISABLING, é possível emitir qualquer dos comandos a seguir
para limpar as tarefas que estão usando o arquivo e desativar o arquivo:
- EXEC CICS SET FILE DISABLED FORCE
- EXEC CICS SET FILE CLOSED FORCE
- CEMT SET FILE FORCECLOSE
Quando as tarefas tiverem sido limpas,
o pacote configurável CICS é movido para o estado
DISABLED. Observe que fechar um arquivo usando a opção FORCE faz com que as tarefas de
quaisquer usuários atuais do arquivo sejam parados imediatamente pelo mecanismo FORCEPURGE
da tarefa CICS. A integridade de dados não é garantida
com este mecanismo. Em alguns casos extremos (por exemplo, se ocorrer um erro durante o
processamento de restauração), o CICS pode encerrar de
maneira anormal. Por este motivo, feche os arquivos usando a opção FORCE somente em circunstâncias excepcionais.