Diagnosticando Erros de Aplicativo
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
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 respostanã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.
- Na visualização do Cloud Explorer, use a lista suspensa alternar hierarquia
- 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 às versões do aplicativo em um ambiente multiversões, portanto, você deve declarar pontos de entrada do aplicativo para recursos CICS adequados 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
eProcurar
. - 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.
- 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
- Se o status de disponibilidade de uma parte de gerenciamento é apresentado como
- 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.
- 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
Tópico pai: Trabalhando com Aplicativos