Diagnostic des erreurs d'application

Si une version d'application déployée sur une plateforme n'a pas le statut attendu, voici quelques causes possibles.

Recherche d'informations de diagnostic sur les applications

Voir Mise en place d'une application pour plus d'informations sur le processus de mise en place d'une application.

Dans CICS Explorer®, utilisez la vue Cloud Explorer dans la perspective CICS® Cloud pour vérifier l'état de la version de l'application. États de l'application explique les valeurs possibles pour l'état d'une version de l'application et de ses éléments de gestion.

Le statut d'une version de l'application est FAILED

Consultez le journal de sortie CICSPlex® SM (l'EYULOG) pour obtenir des détails sur le problème qui s'est produit pendant l'installation ou l'élimination de la version de l'application.

Le référentiel de données CICSPlex SM pour le CMAS peut être plein, auquel cas vous devez augmenter sa capacité. Pour développer le référentiel de données, utilisez la fonction REPRO de l'utilitaire IDCAMS. Le membre EYUJXDRP de la bibliothèque CICSTSnn.CPSM.SEYUSAMP, où CICSTSnn est votre version, est un exemple de JCL permettant d'effectuer cette opération. Par exemple, la bibliothèque est CICSTS64.CPSM.SEYUSAMP pour CICS TS beta. Dans ce langage JCL, sur l'instruction RECORDS(xx,yy), indiquez une valeur principale (xx) et une valeur secondaire (yy) appropriées à votre environnement.

Le statut d'une version d'application est DISABLED ou SOMEDISABLED

Essayez d'activer la version complète de l'application. Dans la vue de l'explorateur de nuages, cliquez avec le bouton droit de la souris sur la version de l'application et sélectionnez Activer. CICSPlex SM tente d'activer tous les CICS bundles pour la version de l'application dans toutes les CICS régions. Si la version de l'application n'est toujours pas activée, examinez les différents CICS bundles qui sont nommés dans chaque partie de gestion. Dans la vue Explorateur de cloud, à l'aide de la hiérarchie d'applications, développez chaque type de région affiché dans l'application pour afficher la liste des bundles du type de région. Développez toutes les listes des bundles pour afficher les composants de gestion de l'application.

L'état d'un organe de gestion est DISABLED ou SOMEDISABLED

Essayez d'activer les bundles CICS individuels dans chaque région CICS où ils sont installés. Double-cliquez sur la partie gestion pour ouvrir la vue CICS Bundles, qui affiche les CICS bundles installés. Sinon, cliquez avec le bouton droit de la souris sur le composant de gestion, puis sur Afficher les bundles installés. Dans la vue CICS Bundles, sélectionnez l'enregistrement de l'ensemble CICS dans la région CICS où vous souhaitez l'activer, cliquez avec le bouton droit de la souris et sélectionnez Enable.

Si l'ensemble CICS reste désactivé, vérifiez sa définition pour voir s'il dépend d'une importation pour une ressource qui n'est pas présente dans la région CICS.

Rappel: Si une liasse CICS contenant la définition d'une ressource LIBRARY privée pour une application est désactivée, CICS ne tente pas de charger des modules de programme à partir d'autres concaténations LIBRARY privées pour l'application, ou à partir des concaténations LIBRARY publiques dans l'ordre de recherche global. Au lieu de cela, une réponse not found (introuvable) est renvoyée à la tâche. Cette action évite la possibilité de charger le mauvais programme et permet à la gestion de la charge de travail d'acheminer le travail hors de la région CICS. Tous les paquets CICS contenant des définitions de ressources LIBRARY doivent donc être activés pour effectuer les chargements de programmes pour l'application.

Le statut d'une version de l'application est INCOMPLET ou VIDE

Examinez les différents CICS bundles qui sont nommés dans chaque partie de gestion... Dans la vue Explorateur de cloud, à l'aide de la hiérarchie d'applications, développez chaque type de région affiché dans l'application pour afficher la liste des bundles du type de région. Développez toutes les listes des bundles pour afficher les composants de gestion de l'application. Double-cliquez sur la partie gestion pour ouvrir la vue CICS Bundles. Sinon, cliquez avec le bouton droit de la souris sur le composant de gestion, puis sur Afficher les bundles installés.

Si l'état d'une partie de gestion est INVALIDSCOPE, vérifiez la définition de l'ensemble CICS pour voir si le groupe de systèmes CICS cible a été spécifié correctement.
Si l'état d'une partie de gestion est VIDE, vérifiez si les régions CICS où l'ensemble CICS aurait dû être installé sont actives et connectées au CMAS. Pour vérifier si les régions CICS sont actives, passez à la hiérarchie des plateformes dans la vue de l'explorateur de nuages. Pour la plate-forme sur laquelle l'application est installée, développez les types de régions, puis développez la liste des régions pour chaque type de région afin d'afficher les régions CICS et leur état. Si les régions CICS sont disponibles, vérifiez la définition de l'ensemble CICS pour voir s'il y a des erreurs.
Si l'état d'une partie de gestion est INCOMPLETE, vérifiez le journal CICSMSG des régions CICS dans le type de région de l'ensemble affecté pour plus d'informations sur la raison pour laquelle l'ensemble n'a pas été installé. Si le paquet CICS ne peut être trouvé, vérifiez votre zFS. Cette erreur peut se produire si
- Une plate-forme est répartie sur différents systèmes (LPAR) dans le même sysplex, mais le répertoire personnel de la plate-forme dans le système de fichiers zFS n'est pas partagé dans le sysplex. Vous devez utiliser FTP à l'aide d'une connexion au même système de fichiers zSeries sur lequel votre CMAS est exécuté ou définir un partage à l'échelle du sysplex de votre répertoire principal de plateforme.
- Le répertoire d'accueil de la plate-forme se trouve sur un sysplex différent de celui où la plate-forme est installée. Vérifiez que le répertoire de base de la plateforme se trouve sur le sysplex où vous avez installé la plateforme.

Vous avez des problèmes avec les ressources privées

Étudier les ressources privées individuelles. Dans la vue Explorateur de cloud, cliquez deux fois sur le nom de la version d'application installée pour l'ouvrir dans l'éditeur d'application en ligne et sélectionnez l'onglet Ressources privées. Sélectionnez l'onglet approprié pour le type de ressource afin d'afficher les ressources privées installées pour l'application. Assurez-vous que chaque ressource privée attendue existe dans toutes les régions CICS appropriées et vérifiez l'absence d'anomalies dans l'état et les informations détaillées de celle-ci.

Si votre application dispose de ressources LIBRARY privées, sélectionnez l'onglet Library DS Names pour afficher le nom DD que z/OS® a généré pour chaque concaténation d'ensembles de données LIBRARY. Vérifiez que ces fichiers ont été créés correctement.

Le statut de la demande ne passe pas à DISPONIBLE

Si vous exécutez l'action Rendre disponible pour rendre une application disponible pour les appelants, mais que l'état de disponibilité affiché n'est pas AVAILABLE, vérifiez d'abord que cette action est requise.

Si l'état de disponibilité de la version d'application affiché est Aucun point d'entrée (ce qui correspond à l'état NONE), l'application ne dispose d'aucun point d'entrée d'application. L'action Rendre disponible n'est donc pas requise. Les points d'entrée de l'application sont utilisés pour contrôler l'accès des utilisateurs aux versions de l'application dans un environnement multi-version. Vous devez donc déclarer les points d'entrée de l'application pour les ressources PROGRAM, TRANSACTION ou URIMAP dans l'application.

Si vous exécutez l'action Rendre disponible pour rendre une application disponible pour les appelants et que cette action est requise, mais que l'état de disponibilité de la version d'application reste UNAVAILABLE ou SOMEAVAIL pendant une longue période, examinez les différents composants de gestion pour la version d'application. Dans la vue Explorateur de cloud, à l'aide de la hiérarchie d'applications, développez chaque type de région affiché dans l'application pour afficher la liste des bundles du type de région. Développez toutes les listes des bundles pour afficher les composants de gestion de l'application.

Si l'état de disponibilité d'une partie de gestion est affiché comme No entry points (ce qui correspond à l'état NONE), le CICS bundle ne contient aucune déclaration de points d'entrée d'application, et il n'est donc pas nécessaire de l'examiner.
Si l'état de disponibilité d'une partie de gestion est affiché comme étant DISPONIBLE, les points d'entrée de l'application déclarés dans la liasse CICS ont été mis à la disposition des appelants et il n'est donc pas nécessaire d'effectuer des recherches.
Si l'état de disponibilité d'une partie de gestion est affiché comme UNAVAILABLE ou SOMEAVAIL, vérifiez l'état des différents CICS bundles et bundle parts, qui représentent les ressources installées pour un CICS bundle.

Vérifiez si l'une des situations suivantes s'applique :

Un point d'entrée de l'application est déclaré dans le paquet CICS avec un nom d'opération qui duplique un nom d'opération utilisé ailleurs dans l'application. Pour éviter cette situation, assurez-vous que les noms d'opération sont uniques dans une application. Les noms d'opération sont sensibles à la casse. Vous pouvez donc utiliser des noms d'opération différenciés uniquement par leur casse, par exemple, browse et Browse.
Une ressource URIMAP déclarée dans le paquet CICS comme point d'entrée d'application n'existe pas ou est déjà réservée comme point d'entrée d'application pour une autre application. Pour éviter ces situations, définissez la ressource URIMAP avec un nom unique dans votre environnement.
Un programme déclaré dans le bundle CICS comme point d'entrée de l'application est un programme privé défini dans l'un des bundles CICS déployés avec la version de l'application. Cependant, un programme portant ce nom est déjà installé en tant que programme public dans la région CICS. Les programmes déclarés en tant que point d'entrée d'application doivent disposer d'un nom de ressource PROGRAM unique dans votre environnement. Pour éviter cette situation, renommez le programme privé dans sa définition de ressource et dans la déclaration de point de déclaration d'entrée d'application pour rendre son nom unique. Plusieurs versions de la même ressource PROGRAM privée définie comme point d'entrée d'application peuvent être installées pour plusieurs versions de la même application, car CICS gère la promotion de ressources PROGRAM privées vers l'état public pour les versions d'une application.
Une version précédente de l'application déclarait comme point d'entrée de l'application un programme qui n'était pas défini dans l'un des CICS bundles déployés avec la version de l'application, et qui était déjà installé en tant que programme public. Lorsque la version de l'application a été activée, CICS a réservé le programme public installé comme point d'entrée de l'application. Cependant, CICS ne peut plus gérer automatiquement les points d'entrée de l'application pour les nouvelles versions de l'application, car un programme public qui a été installé avant l'application ne peut pas devenir un programme privé. Pour mettre à jour l'application vers une nouvelle version, vous devrez désactiver et supprimer la version existante. Pour éviter cette situation, vous pouvez faire en sorte que le programme public soit installé automatiquement par le processus d'installation d'application. Il peut alors devenir un programme privé et permettre à de futures versions d'application d'être installées en même temps. Vous pouvez également définir le programme dans l'un des CICS bundles déployés avec la version de l'application, en veillant à ce qu'il porte un nom unique, ce qui en fait un programme privé.

Vous ne pouvez pas désactiver une version d'application

Vérifiez que l'action Rendre indisponible a été exécutée pour la version de l'application, le cas échéant. Dans les régions CICS de CICS TS 5.3, si le statut de disponibilité de la version de l'application est affiché comme DISPONIBLE, vous devez exécuter l'action Rendre indisponible pour rendre la version de l'application indisponible pour les appelants avant de la désactiver.

Si votre application a été rendue indisponible en cas de besoin et que vous avez exécuté l'action Disable, mais que la version de l'application reste dans l'état DISABLING, examinez les différents CICS bundles qui sont nommés dans chaque partie de la gestion.

Dans la vue Explorateur de cloud, à l'aide de la hiérarchie d'applications, développez chaque type de région affiché dans l'application pour afficher la liste des bundles du type de région. Développez toutes les listes des bundles pour afficher les composants de gestion de l'application. Localisez tout groupe CICS qui n'est pas encore désactivé. Sélectionnez l'enregistrement de la liasse CICS dans la région CICS où elle n'est pas encore désactivée, cliquez avec le bouton droit de la souris et sélectionnez Disable.
Si l'ensemble CICS n'est toujours pas désactivé, affichez ses parties de l'ensemble dans la vue Parties de l'ensemble pour identifier et vérifier l'état des ressources individuelles qui ont été installées pour l'ensemble CICS. Vérifie l'état de toute ressource LIBRARY ou PROGRAM définie dans l'ensemble CICS. La ressource BUNDLEPART associée à une ressource LIBRARY ne signale pas un état DISABLED tant que la concaténation LIBRARY du programme dynamique et tous les programmes chargés depuis celle-ci n'ont pas un compteur d'utilisation à zéro. Pour une ressource PROGRAM, bien que CICS désactive le programme lorsque l'opération de désactivation est effectuée sur l'ensemble CICS à partir duquel il a été installé, la ressource BUNDLEPART associée reste activée jusqu'à ce que le compte d'utilisation du programme atteigne zéro. Si le compte d'utilisation n'atteint pas zéro après un intervalle acceptable, il peut être nécessaire de purger le travail de CICS pour que le processus de désactivation du bundle puisse se terminer.
Vérifie l'état de toute ressource JVMSERVER ou TCPIPSERVICE définie dans l'ensemble CICS. Par défaut, ces ressources ne sont pas désactivées tant que toutes les tâches en cours n'auront pas fini de les utiliser.
- Pour une ressource JVMSERVER, si vous souhaitez désactiver immédiatement le serveur JVM et purger les tâches qui y sont exécutées, utilisez la commande SET JVMSERVER PURGE, FORCEPURGE ou KILL sur la ressource générée dynamiquement dans la région CICS. Vous pouvez effectuer cette action dans CICS Explorer.
- Pour une ressource TCPIPSERVICE, si vous souhaitez désactiver le service immédiatement et fermer toutes les connexions, utilisez la commande SET TCPIPSERVICE IMMCLOSE sur la ressource générée dynamiquement dans la région CICS. Vous pouvez effectuer cette action dans CICS Explorer.
Vous ne pouvez pas utiliser ces méthodes pour désactiver la ressource à moins d'avoir déjà effectué l'action Disable sur le CICS bundle.
Vérifiez l'état de toute ressource FILE définie dans l'ensemble CICS et vérifiez également le journal des messages CICS pour le message DFHFC6043. CICS émet ce message lorsque vous avez tenté de désactiver un fichier défini dans un ensemble CICS, mais que le fichier est toujours utilisé, ou qu'il y a un verrou conservé sur le fichier.
- Si le fichier est dans l'état DISABLED et que CICS a émis le message DFHFC6043, pour un fichier récupérable, vérifiez et résolvez le verrou retenu. Pour un fichier non récupérable, vérifiez les tâches qui utilisent le fichier, et purgez-les ou laissez leur le temps de se finir. Lorsque le processus approprié est terminé, l'ensemble CICS passe à l'état DISABLED.
- Si le fichier est à l'état DISABLING, vous pouvez lancer les commandes suivantes pour purger les tâches qui utilisent le fichier et désactiver ce dernier :
  - EXEC CICS SET FILE DISABLED FORCE
  - EXEC CICS SET FILE CLOSED FORCE
  - CEMT SET FILE FORCECLOSE
  Lorsque les tâches ont été purgées, le groupe CICS passe à l'état DISABLED. Notez que la fermeture d'un fichier à l'aide de l'option FORCE entraîne l'arrêt immédiat des tâches de tous les utilisateurs actuels du fichier par le mécanisme FORCEPURGE de la tâche CICS. Ce mécanisme ne garantit nullement l'intégrité des données. Dans certains cas extrêmes (par exemple, si une erreur se produit pendant le traitement du backout), CICS peut se terminer de manière anormale. Pour cette raison, ne fermez les fichiers à l'aide de l'option FORCE que dans des circonstances exceptionnelles.