Si une version d'application déployée sur une plateforme ne présente pas l'état attendu, suivez cette procédure de dépannage afin de prendre les mesures appropriées.
Avant de commencer
Utilisez la vue Explorateur de cloud dans la perspective CICS Cloud pour vérifier l'état de la version d'application.
Vérification de l'état d'une application explique comment utiliser la vue et répertorie les valeurs d'état possibles d'une version d'application et des composants de gestion. Une version d'application est activée si les bundles CICS
référencés par les composants de gestion de la version d'application ont été installés dans les zones d'écran
CICS et tous activés. Dans les régions CICS de CICS TS 5.2, une version
d'application activée n'est pas encore disponible pour les appelants via ses points d'entrée d'application. Lorsque la version d'application est rendue disponible, les points d'entrée d'application, et donc les ressources qu'ils
contrôlent pour l'application, sont disponibles pour les appelants.
Procédure
- Si l'état d'une version d'application est FAILED, vérifiez le journal sortant de
CICSPlex SM (EYULOG) pour plus d'informations sur le problème qui s'est
produit lors de l'installation ou de la suppression de l'application. Le référentiel de données CICSPlex SM
de l'espace adresse CICSPlex SM (CMAS) peut être plein,
auquel cas vous devez augmenter sa taille. Pour développer le référentiel de données, utilisez la fonction REPRO de l'utilitaire IDCAMS. Pour ce faire, un exemple du langage JCL est disponible dans le membre EYUJXDRP de la bibliothèque CICSTS51.CPSM.SEYUSAMP. Dans ce langage JCL, sur l'instruction RECORDS(xx,yy), indiquez une valeur principale (xx) et une valeur secondaire (yy) appropriées à votre environnement. Les valeurs initiales sont de
500 et 3000.
- Si l'état d'une version d'application est DISABLED ou SOMEDISABLED, essayez d'activer l'application entière.
- Dans la vue Explorateur de cloud, cliquez avec le bouton droit de la souris sur la version d'application et sélectionnez Activer. Si la version d'application est ouverte dans l'éditeur d'application en ligne, utilisez
le bouton Activer de l'onglet Présentation. CICSPlex SM
tente d'activer tous les bundles CICS de la version d'application dans toutes
les régions CICS.
- Vérifiez le nouvel état pour voir si la version d'application est à présent activée. Si la version d'application n'est pas activée, étudiez
les différents bundles CICS qui sont nommés dans chaque composant de gestion. Dans la vue Explorateur de cloud,
utilisez la liste déroulante
de hiérarchie de commutateurs pour passer à la hiérarchie d'application. Grâce à la hiérarchie d'application,
développez chaque type de région affiché sous l'application pour accéder à la
liste des bundles du type de région concerné. Développez chaque liste des bundles pour afficher le composant de gestion de l'application.
- Si l'état d'un composant de gestion est DISABLED ou SOMEDISABLED, tentez d'activer les différents bundles
CICS dans chaque région
CICS où ils sont installés.
- Cliquez deux fois sur le composant de gestion pour ouvrir la vue Bundles CICS qui
affiche les bundles CICS 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 Bundles CICS, sélectionnez l'enregistrement du bundle CICS de la région CICS où vous souhaitez l'activer, puis cliquez avec le bouton droit de la souris sur Activer.
- Si le bundle CICS reste désactivé, vérifiez sa définition pour voir s'il a une dépendance sur l'importation d'une ressource ne figurant pas dans la région CICS.
Conseil : Si un bundle CICS contenant la définition d'une ressource
LIBRARY privée pour une application est désactivé, CICS n'essaye pas de charger des
modules de programme depuis d'autres concaténations LIBRARY privées pour l'application, ou depuis les concaténations
LIBRARY publiques dans l'ordre de recherche globale. Au lieu de cela, une réponse "not found" (introuvable) est renvoyée à la tâche. Cette
action empêche le chargement du programme incorrect et permet à la gestion de charge de travail de router le travail en dehors de la
région CICS. Tous les bundles CICS contenant des définitions de ressources LIBRARY doivent donc être activés pour exécuter les chargements de programme pour l'application.
- Si l'état d'une version d'application est INCOMPLETE ou EMPTY, étudiez les différents bundles
CICS qui sont nommés dans chaque composant de gestion :
- Dans la vue Explorateur de cloud,
utilisez la liste déroulante
de hiérarchie de commutateurs pour passer à la hiérarchie d'application. Grâce à la hiérarchie d'application,
développez chaque type de région affiché sous l'application pour accéder à la
liste des bundles du type de région concerné.
Développez toutes les listes des bundles pour afficher les composants de gestion de l'application. Pour gérer les bundles CICS installés, cliquez deux fois sur le composant de gestion pour ouvrir la vue Bundles CICS. 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'un composant de gestion est INVALIDSCOPE,
vérifiez la définition du bundle CICS pour
vérifier si le groupe de systèmes CICS cible
a été correctement spécifié.
- Si l'état d'un composant de gestion est EMPTY, vérifiez si les régions CICS où le bundle CICS doit être installé, sont
actives et connectées à l'espace adresse CICSPlex SM (CMAS). Pour vérifier si les régions CICS
sont actives, utilisez la liste déroulante
de hiérarchie de commutateurs pour passer à
la hiérarchie de plateforme dans la vue Explorateur de cloud. Dans la plateforme où l'application est installée, développez les types de régions, puis développez la liste Régions de chaque type de région pour afficher les régions CICS et leur état. Si les régions CICS sont disponibles, vérifiez si la définition du bundle CICS ne présente pas
d'erreurs.
- Si l'état du composant de gestion est INCOMPLETE, consultez le journal CICSMSG des régions
CICS du type de région du bundle concerné
pour plus d'informations sur les raisons pour lesquelles le bundle n'a pas été installé. Si le bundle CICS est introuvable, vérifiez votre configuration
de système de fichiers zSeries.
- Cette erreur peut se produire lorsqu'une plateforme est distribuée à travers différents
systèmes (LPARs) dans le même sysplex, mais que le référentiel principal de la plateforme dans le
système de fichier zFS n'est pas partagé à travers 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.
- Cette erreur peut également se produire si le répertoire de base de plateforme se trouve sur un
sysplex différent de celui sur lequel la plateforme 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.
- Si vous êtes confronté à un problème lié à une ressource
privée qui a été installée dans une région CICS pour une version d'application individuelle,
examinez les ressources privées.
- 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. Pour filtrer les ressources privées selon la région CICS où elles sont installées,
sélectionnez la hiérarchie de régions dans la sous-fenêtre Structure. Sinon,
pour filtrer les ressources privées selon le bundle CICS où elles sont définies,
sélectionnez la hiérarchie de bundles dans la sous-fenêtre Structure.
- 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. Pour gérer une ressource privée, cliquez deux fois sur son nom pour l'ouvrir dans un éditeur.
- Si votre application dispose de ressources LIBRARY privées, sélectionnez l'onglet Noms de fichiers de bibliothèque
pour afficher le nom de définition de données (DD) que z/OS a généré pour chaque concaténation LIBRARY de fichiers. Vérifiez que ces fichiers ont été créés correctement.
- 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 n'est pas du tout affiché, ceci est correct pour des régions
CICS qui sont encore au niveau
CICS TS 5.1. L'action Rendre disponible ne s'applique pas aux applications dans ces régions, car celles-ci sont disponibles pour les appelants dès qu'elles sont
à l'état ENABLED.
- 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 d'application sont utilisés pour contrôler l'accès des utilisateurs à différentes versions
d'application dans un environnement de gestion de versions multiples. Vous devez donc déclarer des points d'entrée
d'application pour les ressources PROGRAM 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 tous les types de région affichés
sous l'application pour afficher la liste des bundles du type de région. Développez toutes les listes de bundles pour afficher les composants de gestion de l'application.
- Si l'état de disponibilité d'un composant de gestion affiché est "Aucun point d'entrée" (ce qui correspond à l'état NONE), le bundle CICS ne contient pas d'instructions
de points d'entrée d'application. Vous n'avez donc pas besoin de l'examiner.
- Si l'état de disponibilité d'un composant de gestion affiché est AVAILABLE, les points d'entrée d'application déclarés dans le
bundle CICS ont été rendus disponibles avec succès pour les appelants. Vous n'avez
donc pas besoin de l'examiner.
- Si l'état de disponibilité d'un composant de gestion affiché est UNAVAILABLE ou SOMEAVAIL, vérifiez l'état des différents
bundles CICS et composants de bundle qui représentent les ressources
installées pour un bundle CICS. Pour gérer les bundles CICS installés, cliquez deux fois sur le composant de gestion pour ouvrir la vue Bundles CICS. Sinon, cliquez avec le bouton droit de la souris sur le composant de gestion, puis sur Afficher les bundles
installés. Pour afficher les composants de bundle pour les ressources individuelles qui ont été installées
pour le bundle CICS, cliquez avec le bouton droit de la souris sur le nom du bundle CICS dans la vue Bundles et cliquez sur
Afficher les composants de bundle. Vérifiez si l'une des situations suivantes s'applique :
- Un point d'entrée d'application est déclaré dans le bundle
CICS avec un nom d'opération qui est le même qu'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 bundle 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 d'application est
un programme privé défini dans l'un des bundles CICS déployés avec la version
d'application. Cependant, un programme de ce nom est déjà installé dans un 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 a déclaré comme point d'entrée d'application un programme qui n'a pas été défini
dans l'un des bundles CICS déployés avec la version d'application et a déjà
été installé en tant que programme public. Lorsque la version d'application a été activée,
CICS a réservé le programme public installé comme point d'entrée d'application. Cependant, CICS ne peut pas gérer automatiquement les points d'entrée d'application pour les
nouvelles versions de l'application,
car un programme public qui avait é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 les bundles CICS déployés avec la
version d'application, en veillant à ce qu'il ait un nom unique et le transformer donc en programme privé.
- Si 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 d'application là où c'est nécessaire.
- Dans des régions CICS au niveau
CICS TS 5.2, si l'état de disponibilité de la version d'application affiché est
AVAILABLE, vous devez effectuer l'action Rendre indisponible pour que cette version d'application soit indisponible pour les appelants avant que vous la désactiviez.
- Si votre plateforme inclut des régions CICS qui sont encore à la version
CICS TS 5.1, l'action Rendre indisponible ne s'applique pas aux
applications dans ces régions. Leur état de disponibilité n'est pas affiché.
- Si l'une de vos applications n'a pas de point d'entrée d'application, l'action
Rendre indisponible n'est pas obligatoire pour ces applications. Leur état de disponibilité affiché est
"Aucun point d'entrée".
- Si votre application a été rendue indisponible là où c'était nécessaire et que vous avez exécuté l'action
Désactiver, mais que la version d'application reste à l'état DISABLING,
étudiez les différents bundles CICS qui sont nommés dans chaque composant 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 de bundles pour afficher les composants de gestion de l'application. Pour gérer les bundles CICS installés, cliquez deux fois sur le composant de gestion pour ouvrir la vue Bundles CICS. Sinon, cliquez avec le bouton droit de la souris sur le composant de gestion, puis sur Afficher les bundles
installés.
- Dans la vue Bundles CICS, recherchez tout bundle
CICS qui n'est pas encore désactivé. Sélectionnez l'enregistrement du bundle CICS dans la région CICS où il n'est pas encore désactivé, cliquez avec le bouton droit de la souris, puis sélectionnez Désactiver.
- Si le bundle CICS n'est toujours pas désactivé, affichez ses composants dans la vue
Composantes du bundle pour identifier et vérifier l'état des ressources individuelles qui ont été installées pour le bundle
CICS. Pour afficher les composants d'un bundle, cliquez avec le bouton droit de la souris sur le nom du bundle CICS dans la vue Bundles et cliquez sur
Afficher les composants de bundle.
- Vérifiez l'état de toute ressource LIBRARY ou PROGRAM définie dans le bundle
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, même si CICS désactive le programme lorsque l'opération de désactivation est exécutée sur le bundle CICS depuis lequel elle a été installée,
la ressource BUNDLEPART associée reste activée tant que le compteur d'utilisation n'a pas atteint zéro. Si le compteur 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 de bundle puisse se terminer.
- Vérifiez l'état de toute ressource JVMSERVER ou TCPIPSERVICE définie dans le bundle
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 le serveur JVM immédiatement et purger les tâches qui s'exécutent sur
celui-ci, 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 serveur 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 sauf si vous avez déjà exécuté l'action
Désactiver sur le bundle CICS.
- Vérifiez l'état de toute ressource FILE définie dans le bundle
CICS et recherchez le message DFHFC6043 dans le journal des messages
CICS. CICS émet ce message lorsque vous avez tenté de désactiver un bundle
CICS, mais que le fichier est toujours en cours d'utilisation, ou qu'il existe un verrou conservé sur le fichier.
- Si le fichier est à l'état DISABLED et que CICS a émis le message DFHFC6043, pour un fichier récupérable, vérifiez et résolvez le verrou conservé. 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é,
le bundle 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 bundle
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 des utilisateurs actuels du fichier par le mécanisme FORCEPURGE de 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 lors du traitement d'annulation),
CICS risque de se fermer de manière anormale. Pour cette raison,
ne fermez les fichiers à l'aide de l'option FORCE que dans des circonstances exceptionnelles.