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 d'un bundle d'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 regroupements CICS à l'aide du contrôle des versions. Vous devez appliquer une stratégie de gestion de versions à vos bundles CICS et bundles de gestion pour déployer et gérer les 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 elle 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 principaux, secondaires ou micros 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 secondaire de la version, et des changements incompatibles incrémentent son composant principal. Pour plus d'informations sur la gestion de versions sémantique, voir Livre blanc technique de gestion de versions sémantique.

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 un bundle d'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 regroupement 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 principale, secondaire 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 un bundle d'application, vous devez mettre à jour le bundle d'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 un bundle d'application et une liaison d'application.
    1. Mettez à jour le regroupement d'applications avec la nouvelle version du regroupement CICS du fichier bundles.xml du regroupement d'applications.
    2. Incrémentez les numéros de version principale, secondaire ou micro de l'application dans le fichier application.xml du bundle d'application.
    3. Incrémentez les numéros de version principale, secondaire ou micro de l'application dans le fichier appbinding.xml de la liaison d'application.
    4. Incrémentez les numéros de version principale, secondaire ou micro de la liaison d'application dans le fichier appbinding.xml de la liaison d'application.
  6. Si le regroupement CICS est déployé avec une liaison d'applications, mettez à jour le fichier bundles.xml de la liaison d'applications pour spécifier la nouvelle version du regroupement CICS, et mettez à jour le fichier deployment.xml de la liaison d'applications pour indiquer les types de région dans lesquels la nouvelle du regroupement 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 des applications explique comment utiliser l'éditeur de liaison d'application pour mettre à jour une liaison d'application.
  7. Redéployez le bundle CICS ou le bundle d'application et la liaison d'application qu'il comprend, 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 le bundle CICS n'est pas référencé par un bundle d'application :
    1. 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.
  9. Si le regroupement CICS est référencé par un regroupement d'applications, suivez la procédure de Mise à jour des applications pour désactiver et annuler la ressource APPLCTN installée, créer une définition de ressource APPLDEF et installer la nouvelle définition de ressource APPLDEF.

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.