Utilisez l'assistant d'exportation pour déployer l'application et la liaison d'application mises à jour dans le répertoire de base de la plateforme sur z/OS UNIX et utilisez une définition de ressource APPLDEF pour les installer sur la plateforme.
Pourquoi et quand exécuter cette tâche
Les applications déployées sur des plateformes qui utilisent les ressources
CICS prises en charge en tant que ressources privées, combinées avec d'autres ressources conçues pour des applications et des ressources
importées, sont éligibles pour la gestion de versions multiples. Les ressources suivantes sont prises en charge
dans des applications gérant des versions multiples :
- Ressources PROGRAM définies dans des bundles CICS faisant partie
de l'application
- Ressources LIBRARY définies dans des bundles CICS faisant partie
de l'application
- Règles
- Instructions de points d'entrée d'application
- Toute ressource définie comme une dépendance, ou importation, pour l'application
Si votre application utilise uniquement ces ressources, vous pouvez installer
et rendre disponibles plusieurs versions de l'application en même temps sur
la plateforme. Si votre application utilise des ressources qui ne sont pas prises en charge pour la gestion de versions multiples, vous devez désactiver et supprimer la version existante de l'application avant d'installer une nouvelle version. Sinon, avant d'exporter l'application, vous pouvez l'éditer pour renommer les ressources qui ne sont pas prises en charge pour la gestion de versions multiples,
afin qu'elles n'entrent pas en conflit avec les ressources installées pour des versions précédentes de l'application.
Procédure
- Exportez la nouvelle version de l'application et de la liaison d'application dans le répertoire de base de la plateforme sur
z/OS UNIX.
- Pour ouvrir l'assistant d'exportation, dans la vue Explorateur de projets,
cliquez avec le bouton droit de la souris sur votre projet d'application ou projet de liaison d'application, puis cliquez sur Exporter le projet d'application vers le système de fichiers z/OS UNIX ou
Exporter le projet de liaison d'application vers le système de fichiers z/OS UNIX.
- Vous pouvez également ouvrir l'éditeur d'application ou l'éditeur de liaison d'application et
cliquer sur Export Wizard dans la liste Actions.
Le nouveau numéro de version de l'application est utilisé comme partie intégrante du nom du répertoire. Les versions précédentes de l'application demeurent donc dans le répertoire de base de la plateforme. Les bundles CICS pour lesquels vous n'avez pas incrémenté le numéro de
version, qui sont déjà déployés dans le répertoire de base de la plateforme
et installés dans le CICSplex à la version appropriée ne sont pas inclus dans l'exportation Voir Déploiement d'un projet d'application CICS pour obtenir de l'aide pour l'exportation d'une application.
- Créez une nouvelle définition de ressource APPLDEF avec un nouveau numéro de version de manière à pointer vers le répertoire
d'application pour la nouvelle version de l'application. Une définition de ressource APPLDEF représente un seul version de l'application et ne peut pas être éditée.
Vous devez créer une définition APPLDEF distincte pour gérer chaque version de l'application.
- Pour créer une définition de ressource APPLDEF lors du processus d'exportation, cochez la case dans
l'assistant d'exportation.
- Sinon, dans la vue Explorateur de cloud, cliquez avec le bouton droit de la souris et sélectionnez pour ouvrir l'assistant de nouvelle définition d'application.
Utilisez le même nom que celui que vous avez utilisé pour les définitions de ressource APPLDEF existantes pour
l'application. Indiquez un nouveau numéro de version pour la définition APPLDEF, correspondant au nouveau numéro de version pour l'application de projet, par exemple, 1.1.0. Voir Déploiement d'un projet de plateforme CICS pour obtenir de l'aide pour la création d'une
définition d'application.
- Si votre application utilise des ressources qui ne sont pas prises en charge pour la gestion de versions multiples,
désactivez et supprimez la ressource APPLCTN qui représente la version précédente de l'application. Si votre application utilise uniquement des ressources qui sont prises
en charge dans le cadre d'applications gérant les versions multiples ou si vous avez renommé toutes les ressources
qui sont pas prises en charge pour la gestion de versions multiples, vous n'avez pas besoin de la désactiver.
Ignorez donc cette étape pour éviter toute interruption du service pour les utilisateurs.
- Dans la perspective CICS Cloud, dans la vue Explorateur de cloud, recherchez la version pertinente de l'application installée dans la hiérarchie de plateformes ou d'applications. Cliquez avec le bouton droit de la souris sur le nom de l'application et cliquez sur
Rendre indisponible, puis sur OK pour rendre l'application indisponible. L'application n'est désormais plus disponible pour les appelants via ses points d'entrée d'application.
- Cliquez deux fois sur le nom de l'application pour ouvrir la version d'application installée dans l'éditeur
d'application en ligne. Dans l'onglet
Présentation, sélectionnez l'action Désactiver et supprimer depuis le bouton
Désactiver. CICSPlex SM désactive, puis supprime les
bundles CICS pour la version d'application dans les régions
CICS et désinstalle l'application de la plateforme. Vous pouvez également désactiver et supprimer la version d'application dans la vue Explorateur de Cloud comme suit :
- Cliquez avec le bouton droit de la souris sur le nom de l'application dans la vue Explorateur de cloud,
sélectionnez Désactiver, puis cliquez sur
OK pour confirmer.
- Actualisez la vue Explorateur de cloud, puis vérifiez l'état de l'application pour confirmer que celle-ci est
désactivée. Si l'application n'est pas désactivée, vous trouverez dans Vérification de l'état d'une application plus d'informations et les actions préconisées.
- Lorsque l'application est désactivée, cliquez avec le bouton droit de la souris sur le nom
d'application, sélectionnez Supprimer,, puis cliquez sur OK pour confirmer.
- Actualisez la vue Explorateur de cloud et vérifiez qu'au lieu du
nom de l'application, vous voyez le nom et le numéro de version de la définition d'application (ressource APPLDEF) pour la version
de l'application que vous venez de supprimer. Si CICSPlex SM
ne parvient pas à désactiver ou supprimer un bundle, l'application n'est
pas supprimée. Dans ce cas, vous trouverez dans Vérification de l'état d'une application plus d'informations et
les actions préconisées.
- Installez la nouvelle définition de ressource APPLDEF pour la nouvelle version de l'application, activez la version
de l'application et vérifiez l'installation.
- Dans la vue Explorateur de cloud, recherchez l'application installée avec le nouveau numéro de version correct dans la
hiérarchie de plateformes ou d'applications.
- Cliquez avec le bouton droit de la souris sur la définition d'application et sélectionnez Installer,
puis cliquez sur OK pour confirmer. CICSPlex SM crée la nouvelle ressource APPLCTN pour représenter la nouvelle
version de l'application dans le CICSplex et installe les bundles CICS dans les régions
de la plateforme. Les ressources définies à l'intérieur des bundles CICS sont créées de manière
dynamique dans les régions CICS Dans la vue Explorateur de cloud, le nom de l'application remplace le nom de définition APPLDEF.
- Cliquez avec le bouton droit de la souris sur le nom de l'application et sélectionnez Activer,
puis cliquez sur OK pour confirmer. Vous pouvez également ouvrir l'application dans l'éditeur d'application en ligne et cliquer sur le bouton
Activer dans l'onglet Présentation. CICSPlex SM active les bundles
CICS dans les régions CICS de la plateforme,
mais la version de l'application n'est pas encore disponible pour les appelants via ses points d'entrée d'application.
- Actualisez la vue Explorateur de cloud, puis vérifiez l'état de l'application. Si l'état n'est pas passé ENABLED, suivez la
procédure de traitement des incidents de Diagnostic des erreurs d'application.
- Pour rendre la nouvelle version de l'application disponible pour les utilisateurs de la plateforme, dans la vue Explorateur de cloud, cliquez avec le bouton droit de la souris sur le nom de l'application, puis cliquez sur
Rendre disponible, puis sur OK. Vous pouvez également ouvrir l'application dans l'éditeur d'application en ligne et cliquer sur le bouton
Rendre disponible dans l'onglet Présentation. La version de l'application est
désormais disponible pour les appelants via ses points d'entrée d'application,
qui peuvent être des ressources PROGRAM ou URIMAP.
Résultats
La nouvelle version de l'application est maintenant déployée sur la plateforme. Pour les applications qui sont prises en charge pour la gestion de versions multiples,
si plusieurs versions sont disponibles, les appelants peuvent accéder à la version d'application
la plus élevée disponible ou utiliser la
commande EXEC CICS INVOKE APPLICATION pour spécifier une version disponible de l'application. Pour plus d'informations sur l'appel d'une version spécifique d'une application,
voir Appel d'une application multiversion dans la documentation du produit CICS TS V5.2.
Que faire ensuite
Pour les applications qui sont prises en charge pour la gestion de versions multiples, pour supprimer temporairement ou définitivement d'une plateforme des versions précédentes d'une application, suivez la procédure de
Rendre indisponible, désactiver et supprimer des applications.