Utilisation des éditeurs pour les platesformes, les applications et les règles

Utilisez les éditeurs pour gérer les projets de plateforme, les projets d'application, les projets de liaison d'applications et les projets de regroupements CICS après les avoir créés.

Les éditeurs de plateforme, d'application et de liaison d'applications s'ouvrent automatiquement après la création d'un projet de ce type. Pour ouvrir l'éditeur de manifeste de regroupement après la création d'un regroupement CICS ou ouvrir l'un des éditeurs ultérieurement, accédez à la vue Explorateur de projets de la perspective CICS Cloud. Développez le dossier META-INF du projet et cliquez deux fois sur l'un des fichiers .xml du regroupement, mais pas sur le fichier manifest.xml. Vous pouvez également cliquer à l'aide du bouton droit de la souris sur le fichier, cliquer sur Open With (Ouvrir avec), puis sélectionner le nom de l'éditeur. Lorsque l'éditeur s'ouvre, l'onglet de nom de l'éditeur affiche le nom de la plateforme, de l'application, de la liaison d'applications ou du regroupement CICS.

Si vous ne disposez pas d'un système de secours versionné qui vous permet de retourner vers une version antérieure des projets, au lieu de modifier directement les projets existants, il est préférable de les copier vers un autre projet, puis de modifier les nouvelles copies.

Les erreurs et avertissements lors d'un processus d'édition s'affichent dans la fenêtre de l'éditeur principal, dans l'onglet Problems (Problèmes) de la perspective ou dans la zone d'état du plan de travail.

Pour annuler des modifications avant de les sauvegarder, vous pouvez utiliser la fonction Annuler. Dans le menu de plan de travail, cliquez sur Edit > Undo ou appuyez sur Ctrl-Z.

A l'issue de la mise à jour vers le regroupement d'applications ou le regroupement CICS, mettez toujours à jour les versions majeures, mineures ou micro du regroupement en fonction de votre politique de gestion de versions. CICS valide les numéros de version lors de l'installation d'une application sur la plateforme, et vous devez mettre à jour les numéros de version du regroupement d' applications et la liaison d'applications à chaque mise à jour des regroupements CICS pour l'application. Les regroupements de plateformes n'utilisent pas le contrôle des versions. Pour plus d'informations sur la gestion des versions, voir Contrôle des versions.

Pour sauvegarder vos modifications, cliquez sur l'icône Sauvegarder Icône Sauvegarder ou appuyez sur Ctrl-S. Si vous tentez de fermer l'éditeur sans sauvegarder les modifications, une boîte de dialogue s'affichera pour vous demander si vous souhaitez sauvegarder vos modifications ou fermer sans sauvegarder.

Une fois les modifications sauvegardées, exportez la plateforme ou l'application vers le répertoire principal de la plateforme dans zFS. Sélectionnez l'action d'exportation dans l'onglet de présentation de l'éditeur pour ouvrir l'assistant d'exportation. Une application, sa liaison d'applications et leurs regroupements CICS associés sont exportés en un seul processus. Le nouveau numéro de version est utilisé comme partie intégrante du nom du répertoire. Par conséquent, les versions précédentes des regroupements demeurent dans le répertoire de base de la plate-forme.

Pour installer la plateforme ou l'application dans CICSplex, vous devez utiliser une nouvelle définition de ressource PLATDEF ou APPLDEF qui pointe vers la plateforme correcte ou le répertoire d'application du répertoire de base de la plateforme. Pour créer cette définition de ressource lors du processus d'exportation, cochez la case dans l'assistant d'exportation.

Editeur de plateforme

Utilisez l'éditeur de plateforme pour gérer les regroupements de plateformes qui n'ont pas encore été installés dans CICSplex. Lorsque la plateforme a été installée est activée, vous pouvez installer des menus dans la perspective CICS Cloud pour ajouter et supprimer des régions CICS individuelles dans des types de région. Vous pouvez également ajouter et supprimer des regroupements CICS déployés avec la plateforme. Toutefois, vous ne pouvez pas modifier les types de région d'une plateforme installée. Utilisez l'éditeur de plateforme pour finaliser vos types de région avant d'installer le regroupement de plateformes. Si vous éditez un regroupement de plateformes d'une plateforme déjà installée, vous devez arrêter, annuler, réinstaller et redémarrer la plateforme pour implémenter les modifications.

L'éditeur de plateforme est composé de trois onglets : Présentation, Types de région et Déploiement. La liste des actions de l'onglet Présentation décrit un processus d'édition du projet de plateforme. Elle comporte des liens vers les assistants, ainsi que des onglets permettant de réaliser chaque tâche.

L'onglet Présentation de l'éditeur de plateforme présente l'ID, la description et le répertoire de base de la plateforme, les types de région de la plateforme et les bundles CICS déployés avec la plateforme. Les actions que vous pouvez exécuter sur la plateforme sont indiquées.
Utilisez l'onglet Présentation de l'éditeur de plateforme pour réaliser les tâches suivantes :
  • Modification de l'ID, de la description ou du répertoire de base de la plateforme.
  • Ajout et suppression de types de région de la plateforme. L'onglet Présentation possède des fonctions de base permettant de créer de nouveaux types de région ou d'adopter des types de région à partir d'une topologie existante. Pour modifier les types de région et travailler avec les régions CICS qu'ils contiennent, utilisez l'onglet Types de région. En cliquant deux fois sur le nom d'un type de région, vous accédez au type de région concerné dans l'onglet Types de région.
  • Ajout et suppression de bundles CICS déployés avec la plateforme. Pour éditer l'un de ces bundles CICS, cliquez deux fois sur son nom dans la liste de l'éditeur de plateforme pour ouvrir l'éditeur de manifeste de regroupement.
L'onglet Types de région de l'éditeur de plateforme présente les types de région de la plateforme et les définitions de région CICS des types de région créés. Les types de région adoptés sont marqués comme étant adoptés (Adopted). Si un type de région est sélectionné, l'onglet présente les propriétés et les options avancées du type de région. Si la définition de région CICS est sélectionnée, l'onglet présente les attributs de la définition de région CICS et les types de région contenant la région.
Utilisez l'onglet Types de région de l'éditeur de plateforme pour ces tâches :
  • Ajout et suppression de types de région de la plateforme. Vous pouvez créer des types de région ou en adopter d'une topologie existante.
  • Création de définitions de région CICS dans les types de région créés.
  • Spécification ou édition des propriétés de base des définitions de région CICS dans les types de région créés.
  • Ajout et suppression de définitions de région CICS dans les types de région créés et partage entre les types de région créés. Toutes les définitions de région CICS orphelines qui n'entrent pas dans un type de région s'affichent en haut de la liste. Sélectionnez la région à ajouter à un type de région.
L'éditeur de plateforme ne se connecte pas au CICSplex cible, vous ne pouvez donc pas l'utiliser pour ajouter, supprimer ou partager les régions CICS dans des types de région adoptés. Vous pouvez uniquement gérer les définitions de région CICS dans des types de région créés.

Utilisez l'onglet Déploiement de l'éditeur de plateforme pour mapper les bundles CICS déployés avec la plateformes aux types de région de la plateforme. Utilisez le commutateur Commutateur pour basculer entre les types de région et les bundles CICS.

L'onglet Déploiement de l'éditeur de plateforme présente les types de région de la plateforme et les bundles CICS déployés avec la plateforme. Les types de région et les bundles CICS sont respectivement indiqués dans la première et la deuxième colonne.
Sélectionnez chaque bundle CICS et cochez les cases pour spécifier les types de région vers lesquels ils vont être déployés. Tous les bundles CICS qui ne sont pas encore liés à un type de région sont indiqués avec une erreur.

Editeur d'application et éditeur de manifeste de regroupement

Utilisez l'éditeur d'application et l'éditeur de manifeste de regroupement pour mettre à jour vos applications. Mise à jour des applications décrit le processus de mise à jour d'une application et de déploiement de la nouvelle version de l'application sur votre plateforme. Vous devez également mettre à jour la liaison d'applications lors de la mise à jour de l'application.

L'éditeur d'application comporte uniquement l'onglet Overview (Présentation). La liste des actions de l'onglet Overview est composée de liens vers les assistants que vous pouvez utiliser pour créer des regroupements CICS ou une liaison d'applications pour l'application, et les exporter vers le répertoire de base de la plateforme.

L'onglet Overview de l'éditeur d'application présente l'ID, la version et la description de l'application, les regroupements CICS qui vont être installés dans le cadre de l'application, et les points d'entrée définis par les regroupements CICS référencés. Les actions que vous pouvez exécuter sur l'application sont indiquées.
Utilisez l'onglet Overview de l'éditeur d'application pour ces tâches :
  • Modification de l'ID, de la description ou du numéro de version de l'application.
  • Ajout et suppression de regroupements CICS de l'application.
  • Accès à l'éditeur de manifeste de regroupement pour mettre à jour les regroupements CICS de l'application.
  • Accès à l'éditeur de manifeste de regroupement pour mettre à jour les points d'entrée de l'application.

Pour mettre à jour un regroupement CICS ou un point d'entrée d'application, cliquez deux fois sur son nom dans la liste de l'éditeur d'application pour ouvrir l'éditeur de manifeste de regroupement. L'éditeur de manifeste de regroupement est composé de trois onglets : Overview (Présentation), Entry Points (Points d'entrée) et Policy Scopes (Portées de politique). Vous pouvez utiliser l'éditeur de manifeste de regroupement pour créer des définitions de ressource dans le regroupement CICS, supprimer des définitions de ressource du regroupement CICS, ajouter et supprimer des dépendances sur des ressources importées, créer et éditer des points d'entrée d'application et définir des périmètres de stratégie. Vous pouvez également accéder aux éditeurs de ressource afin d'éditer les ressources existantes définies dans le regroupement CICS. N'oubliez pas d'incrémenter le numéro de version du regroupement CICS à l'issue des mises à jour.

Lorsque vous éditez un regroupement CICS ou un point d'entrée d'application (défini dans un regroupement CICS) pour l'application et incrémentez le numéro de version du regroupement CICS, CICS Explorer marque l'ancienne version avec une erreur dans l'éditeur d'application. Supprimez l'ancienne version du regroupement CICS du regroupement d'application en la sélectionnant et en cliquant sur Remove dans l'éditeur d'application. Inclure le regroupement CICS mis à jour dans le regroupement d'application en cliquant sur Add dans l'éditeur d'application puis sélectionnez la nouvelle version du regroupement CICS dans la liste liste des regroupements CICS disponibles dans votre espace de travail.

A l'issue de toutes les mises à jour vers l'application et les regroupements CICS associés, n'oubliez pas de mettre à jour les numéros de version majeure, mineure ou micro du regroupement d'applications afin de refléter le niveau de modifications apportées (voir Contrôle des versions).

Editeur de liaison d'applications

Utilisez l'éditeur de liaison d'applications pour mettre à jour les informations de déploiement de vos applications. Mise à jour des applications décrit le processus de mise à jour d'une application et d'une liaison d'applications, ainsi que l'utilisation de la liaison d'applications pour déployer la nouvelle version de l'application sur votre plateforme.

L'éditeur de liaison d'applications est composé de deux onglet : Overview (Présentation) et Deployment (Déploiement). La liste des actions de l'onglet Overview comporte des liens vers des assistants que vous pouvez utiliser pour créer des regroupements CICS à déployer avec la liaison d'applications, et pour exporter l'application et la liaison d'applications vers le répertoire de base de la plateforme.

L'onglet Overview de l'éditeur d'application présente l'ID, la version et la description de la liaison d'applications, les regroupements CICS qui vont être installés dans le cadre de l'application, et les politiques définies par les regroupements CICS référencés. Les actions que vous pouvez exécuter sur la liaison d'applications sont indiquées.
Utilisez l'onglet Overview de l'éditeur de liaison d'applications pour ces tâches :
  • Modification de l'ID, de la description ou du numéro de version de la liaison d'applications.
  • Modification de la plateforme ou de l'application référencée par la liaison d'applications.
  • Ajout et suppression de regroupements CICS déployés avec la liaison d'applications.
  • Accès à l'éditeur de manifeste de regroupement pour mettre à jour les regroupements CICS déployés avec la liaison d'applications.
  • Accès à l'éditeur de manifeste de regroupement pour mettre à jour les politiques de l'application.

Pour mettre à jour un regroupement CICS ou une politique, cliquez deux fois sur son nom dans la liste de l'éditeur de liaison d'applications pour ouvrir l'éditeur de manifeste de regroupement. Lors de la mise à jour d'un regroupement CICS ou d'une politique, supprimez du regroupement de liaisons d'applications l'ancienne version du regroupement CICS, puis ajoutez la nouvelle version, comme pour l'éditeur d'application.

Utilisez l'onglet Deployment de l'éditeur de liaison d'applications pour mapper aux types de région de la plateforme cible les regroupements CICS de l'application référencée, ainsi que les regroupements CICS déployés avec la liaison d'applications. Utilisez le commutateur Commutateur pour basculer entre les types de région et les regroupements CICS.
L'onglet Deployment de l'éditeur d'application présente les types de région de la plateforme et les regroupements CICS de l'application et de la liaison d'applications. Les types de région et les regroupements CICS sont respectivement indiqués dans la première et la deuxième colonne.
  • Tous les regroupements CICS qui sont pas encore liés à un type de région sont marqués par la lettre X. En travaillant avec les CICS, sélectionnez chaque nouveau regroupement CICS puis utilisez les cases à cocher pour spécifier les types de région dans lesquelles il doivent être déployés.
  • Tous les types de région spécifiés dans une liaison d'application, mais introuvables dans la version actuelle du projet de plateforme associé à la liaison d'application, sont marqués par un point d'exclamation. Vérifiez que vous travaillez avec la bonne version du projet de plate-forme, et affichez le projet de plateforme de l'éditeur de plateforme pour vérifier les types de région. Si vous avez retiré le type de région type de région de la plate-forme ou que vous êtes passé à une plate-forme qui n'inclut pas le type de région, nettoyez le projet de liaison d'application. En travaillant avec les types de région, cochez chaque type de région non souhaité puis déselectionnez tous les regroupements CICS spécifiés pour ce type de région.

A l'issue de toutes les mises à jour vers les liaisons d'application et les regroupements CICS associés, n'oubliez pas de mettre à jour les numéros de version majeure, mineure ou micro du regroupement de liaison d'applications afin de refléter le niveau de modifications apportées (voir Contrôle des versions).

Contrôle des versions

Vous gérez les modifications aux applications à l'aide de la contrôle des versions. Chaque regroupement CICS, regroupement d'application et liaison d'application a un ID des informations de version permettant de l'identifier de façon unique. La version utilise des identificateurs majeurs, mineurs et micro, donc vous pouvez indiquer la signification d'une modification et gérer les dépendances entre les regroupements. Ce concept s'appelle semantic versioning et est recueilli de OSGi Alliance. Bien qu'il met en évidence les packages Java™, vous pouvez utiliser les mêmes principes pour appliquer les regroupements en général.

La gestion de versions sémantiques permet d'incrémenter des composants majeurs, mineurs ou micro d'une version pour indiquer la compatibilité ou l'incompatibilité avec les versions antérieures d'un regroupement. Par exemple, les correctifs de bogue peuvent incrémenter le composant micro de la version, les modifications compatibles incrémentent le composants mineur de la version et les modifications incompatibles incrémentent le composant majeur de la version. Pour plus d'informations sur la gestion de versions sémantiques, reportez-vous à la rubrique Livre blanc technique de gestion de versions sémantique.

Vous devez appliquer une politique de gestion de versions à vos regroupements CICS et aux regroupements de gestion pour déployer et gérer des mises à jour dans l'environnement CICS. Il est impossible d'utiliser la version d'un regroupement d'application pour installer les nouvelles versions des regroupements CICS pour l'application, il est également impossible d'utiliser une version existante d'une liaison d'application d'un regroupement d'application. Vous devez mettre à jour le regroupement d' application et la liaison d'application à chaque fois que vous mettez à jour les regroupements CICS pour l'application.

Lorsque vous modifiez la version d'un regroupement géré, selon les principes de la gestion de versions sémantiques, la nouvelle version doit refléter la plus grande modification dans un regroupement CICS qui est inclus dans le regroupement de gestion. Par exemple, vous pouvez modifier un regroupement CICS pour une application de la Version 1.0.1 à la Version 1.0.2, qui est une modification de version micro et modifier un autre regroupement CICS pour l'application de la Version 1.2.0 à la Version 1.3.0, qui est une modification de version mineure. Le regroupement de l'application qui inclut ces deux CICS doit cependant avoir une modification de version mineure, donc si l'application était précédemment Version 2.5.1, elle doit être changée à la Version 2.6.0.

Il n'est pas obligatoire que le numéro de version de la liaison d'applications soit identique au numéro de version de l'application associée. Cependant, selon les principes de gestion de versions sémantiques, vous devez mettre à jour le numéro de version pour que la liaison d'application reflète la plus grande modification apportée dans l'application ou dans les applications CICS déployés avec la liaison d'application.