Mise à jour des bundles CICS

L'éditeur de manifeste de bundle et les éditeurs de ressource permettent d'éditer le contenu d'un bundle CICS et d'augmenter son numéro de version. Il vous suffit ensuite de déployer la nouvelle version du bundle CICS, ou une application le contenant, dans vos régions CICS.

Pourquoi et quand exécuter cette tâche

Vous pouvez gérer les modifications apportées aux bundles CICS à l'aide du contrôle des versions. Vous devez appliquer une politique de gestion de versions à vos bundles CICS, bundles d'application et liaisons d'application pour déployer et gérer des mises à jour dans l'environnement CICS.

Chaque bundle est associé à un ID et à des informations de version pour permettre de l'identifier de manière unique. La version est associée à des identificateurs principaux, secondaires et micros, pour vous permettre d'indiquer la signification d'un changement et gérer les dépendances entre bundles. Il s'agit du concept de gestion de versions sémantique qui est issu de l'initiative OSGi. Même si la gestion de versions sémantique concerne principalement les modules Java™, vous pouvez utiliser les mêmes principes pour appliquer les bundles en général.

La gestion de versions sémantique offre la possibilité d'incrémenter les composants majeurs, mineurs ou micro d'une version pour indiquer la compatibilité ou l'incompatibilité avec les versions antérieures d'un bundle. Par exemple, des correctifs d'erreur peuvent incrémenter le composant micro de la version, des changements compatibles incrémentent le composant mineur de la version, et des changements incompatibles incrémentent son composant majeur. Pour plus d'informations sur la gestion de versions sémantique, voir Livre blanc technique sur la gestion des versions sémantiques.

Vous pouvez indiquer qu'un bundle CICS a changé en augmentant le numéro de version dans le fichier du manifeste de bundle. Si le bundle CICS est référencé par une application, vous devez également augmenter la version du bundle d'application pour le redéploiement.

Procédure

  1. Cliquez sur Fenêtre > Afficher vue > Explorateur de projets pour ouvrir la vue de l'explorateur de projets.
  2. Pour éditer un bundle CICS, développez le dossier META-INF du bundle CICS et cliquez deux fois sur le fichier cics.xml. L'éditeur de manifeste de bundle s'ouvre.
  3. Mettez à jour le bundle CICS selon vos besoins. Vous pouvez utiliser l'éditeur de manifeste de bundle pour ajouter et supprimer des dépendances du bundle CICS, créer de nouveaux points d'entrée d'application et définir des périmètres de stratégie. Pour éditer les ressources définies dans le bundle CICS, vous pouvez utiliser les éditeurs de ressource, conformément à la description de Edition de ressources définies dans une projet de bundle CICS.
  4. Une fois que vous avez mis à jour le bundle CICS, vous pouvez utiliser l'éditeur de manifeste de bundle pour incrémenter les numéros de version majeurs, mineurs ou micro du bundle CICS selon votre stratégie de gestion de versions, et enregistrer vos changements.
  5. Si le bundle CICS est référencé par une application, vous devez mettre à jour l'application et la liaison d'application. Mise à jour des applications explique comment utiliser l'éditeur d'application et l'éditeur de liaison d'application pour mettre à jour une application et une liaison d'application.
    1. Mettez à jour l'application avec la nouvelle version du bundle CICS du fichier bundles.xml du bundle d'application.
    2. Incrémentez les numéros de version majeure, mineure ou micro de l'application dans le fichier application.xml du bundle d'application.
    3. Incrémentez les numéros de version majeure, mineure ou micro de l'application dans le fichier appbinding.xml de la liaison d'application.
    4. Incrémentez les numéros de version majeure, mineure ou micro de la liaison d'application dans le fichier appbinding.xml de la liaison d'application.
  6. Si le bundle CICS est déployé avec une application ou une liaison d'application, mettez à jour le fichier bundles.xml de la liaison d'application pour spécifier la nouvelle version du bundle CICS, et mettez à jour le fichier deployment.xml de la liaison d'application pour indiquer les types de région dans lesquels la nouvelle version du bundle CICS est déployée. Incrémentez le numéro de version de la liaison d'application dans le fichier appbinding.xml de la liaison d'application. Mise à jour d'un projet de liaison d'application explique comment utiliser l'éditeur de liaison d'application pour mettre à jour une liaison d'application.
  7. Redéployez le bundle CICS ou l'application et la liaison d'application qui le comprennent, en exportant le projet dans z/OS UNIX. Le nouveau numéro de version est intégré au nom de répertoire du bundle, de sorte que les versions antérieures du bundle restent dans z/OSUNIX.
  8. Si la version précédente du bundle CICS a été installée dans une ou plusieurs régions CICS en tant que bundle CICS autonomes, mettez à jour chaque bundle CICS dans chaque région CICS individuellement.
    1. Rendez indisponible, puis désactivez et supprimez la ressource BUNDLE installée qui représente la version antérieure du bundle CICS.
    2. Editez la définition de ressource BUNDLE de manière à pointer vers le répertoire de bundle mis à jour.
    3. Réinstallez la définition de ressource BUNDLE, activez-la, puis rendez-la disponible.
  9. Si la version précédente du bundle CICS a été déployée avec un bundle de plateforme ou ajoutée à une plateforme, mettez à jour le bundle CICS au niveau de la plateforme.
    1. Désactivez la version précédente du bundle CICS et supprimez-la de la plateforme en suivant les instructions de la section Suppression d'un bundle CICS à partir d'une plateforme.
    2. Ajoutez la nouvelle version du bundle CICS à la plateforme et activez-la en suivant les instructions de la section Ajout d'un bundle CICS à une plateforme.
  10. Si le bundle CICS est référencé par un bundle d'applications, suivez la procédure de Déploiement de nouvelles versions d'applications sur une plateforme pour rendre indisponible, désactiver et supprimer la ressource APPLCTN installée, puis créer et installer une nouvelle définition de ressource APPLDEF. Si votre application utilise uniquement des ressources prises en charge pour la gestion de versions multiples, 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.

Résultats

Le bundle CICS est installé dans les régions CICS appropriées, et les ressources définies au sein du bundle sont créées dynamiquement dans les régions CICS.