Utilisation d'éditeurs pour les plateformes et les applications

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

Les éditeurs de plateforme, d'application et de descripteur 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 bundle après la création d'un bundle 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 bundle, 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, 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 bundle 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.

Lorsque vous gérez des projets pour des applications, vérifiez que le projet de plateforme CICS pour la plateforme cible est présent dans votre espace de travail local, car CICS Explorer a besoin de ce projet pour valider vos applications et vos liaisons d'applications.

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

Pour annuler une ou plusieurs de vos modifications avant de les enregistrer, utilisez la fonction Annuler. Dans le menu de plan de travail, cliquez sur Editer > Annuler ou appuyez sur Ctrl+Z (cmd+Z pour OS X).

A l'issue de la mise à jour vers le bundle d'applications ou le bundle CICS, mettez toujours à jour les versions majeures, mineures ou micro du bundle en fonction de votre règle de gestion des 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 bundle d'applications et la liaison d'applications à chaque mise à jour des bundles CICS pour l'application. Les bundles 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 (cmd+S pour OS X). 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 bundles 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 bundles demeurent dans le répertoire de base de la plateforme.

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.

Une fois que vous avez installé une application dans le CICSplex, vous pouvez l'afficher dans l'éditeur de descripteur d'application en ligne. Vous pouvez utiliser cet éditeur pour activer, désactiver, ou désactiver et supprimer l'application installée, ainsi que pour afficher ses ressources privées. Pour gérer une application installée, accédez à la vue Explorateur de cloud dans la perspective CICS Cloud. Dans le CICSplex dans lequel la plateforme se trouve, sélectionnez la version d'application installée et cliquez deux fois sur le nom de l'application ou cliquez dessus à l'aide du bouton droit de la souris, puis sélectionnez Ouvrir.

Editeur de descripteur de plateforme

L'éditeur de descripteur de plateforme permet d'utiliser les bundles de plateforme qui n'ont pas encore été installés dans un 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 bundles 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 descripteur de plateforme pour finaliser vos types de région avant d'installer le bundle de plateformes. Si vous éditez un bundle 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 descripteur de plateforme est composé de trois onglets : Présentation, Types de région et Déploiement. La section Actions de l'onglet Présentation décrit un processus d'édition du projet de plateforme. Elle comporte des liens vers les assistants et les onglets permettant de réaliser chaque tâche.

Onglet Présentation de l'éditeur de descripteur de plateforme
L'onglet Présentation de l'éditeur de descripteur 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. Cet onglet permet d'effectuer 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 des bundles CICS déployés avec la plateforme. Pour modifier l'un de ces bundles CICS, cliquez deux fois sur le nom du bundle dans la liste de l'éditeur de descripteur de plateforme pour ouvrir l'éditeur du manifeste de bundle.
Onglet Types de région de l'éditeur de descripteur de plateforme
L'onglet Types de région de l'éditeur de descripteur de plateforme présente les types de région de la plateforme et les définitions de région CICS dans les 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. Cet onglet permet d'effectuer les tâches suivantes :
  • 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 descripteur de plateforme ne se connecte pas au CICSplex cible, vous ne pouvez donc pas l'utiliser pour ajouter, supprimer ou partager des régions CICS dans les 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 descripteur de plateforme pour mapper les bundles CICS déployés avec la plateforme aux types de région de la plateforme. Utilisez le commutateur Commutateur pour basculer entre les types de région et les bundles CICS.

Onglet Déploiement de l'éditeur de descripteur de plateforme
L'onglet Déploiement de l'éditeur de descripteur 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 utilisez les cases à cocher pour spécifier les types de région dans lesquels effectuer le déploiement. Tous les bundles CICS qui ne sont pas encore liés à un type de région sont indiqués avec une erreur.

Editeur de descripteur d'application et éditeur de manifeste de bundle

Utilisez l'éditeur de descripteur d'application et l'éditeur de manifeste de bundle 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. Vérifiez que le projet de plateforme CICS pour la plateforme cible est présent dans votre espace de travail local avant de commencer à travailler avec une application ou une liaison d'applications.

L'éditeur de descripteur d'application comporte uniquement l'onglet Présentation. La section Actions de l'onglet Présentation est composée de liens vers les assistants que vous pouvez utiliser pour créer des bundles CICS ou une liaison d'application pour l'application, et les exporter vers le répertoire de base de la plateforme.

Onglet Présentation de l'éditeur de descripteur de d'application
L'onglet Présentation de l'éditeur d'application présente l'ID, la version et la description de l'application, les bundles CICS qui vont être installés dans le cadre de l'application, et les points d'entrée définis par les bundles CICS référencés. Cet onglet permet d'effectuer les tâches suivantes :
  • Modification de l'ID, de la description ou du numéro de version de l'application.
  • Ajout et suppression de bundles CICS pour l'application.
  • Accès à l'éditeur de manifeste de bundle pour mettre à jour les bundles CICS de l'application.
  • Accès à l'éditeur de manifeste de bundle pour mettre à jour les points d'entrée de l'application.

Pour mettre à jour un bundle 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 bundle. L'éditeur de manifeste de bundle est composé de trois onglets : Présentation, Points d'entrée et Portées de règle. Vous pouvez utiliser l'éditeur de manifeste de bundle pour créer des définitions de ressource dans le bundle CICS, supprimer des définitions de ressource du bundle 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 portées de règle. Vous pouvez également accéder aux éditeurs de ressource afin d'éditer les ressources existantes définies dans le bundle CICS. N'oubliez pas d'incrémenter le numéro de version du bundle CICS à l'issue des mises à jour.

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

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

Editeur de descripteur de liaison d'applications

L'éditeur de descripteur de liaison d'applications permet de 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. Vérifiez que le projet de plateforme CICS pour la plateforme cible est présent dans votre espace de travail local avant de commencer à travailler avec une application ou une liaison d'applications.

L'éditeur de descripteur de liaison d'applications est composé de deux onglets : Présentation et Déploiement. La liste des actions de l'onglet Présentation comporte des liens vers des assistants que vous pouvez utiliser pour créer des bundles 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.

Onglet Présentation de l'éditeur d'application
L'onglet Présentation de l'éditeur d'application présente l'ID, la version et la description de la liaison d'applications, les bundles CICS qui vont être installés dans le cadre de l'application, et les règles définies par les bundles CICS référencés. Cet onglet permet d'effectuer les tâches suivantes :
  • Modification de l'ID, de la description ou du numéro de version de la liaison d'application.
  • Modification de la plateforme ou de l'application référencée par la liaison d'application.
  • Ajout et suppression des bundles CICS déployés avec la liaison d'application.
  • Accès à l'éditeur de manifeste de bundle pour mettre à jour les bundles CICS déployés avec la liaison d'application.
  • Accès à l'éditeur de définition de politique pour mettre à jour les politiques définies dans des bundles référencés par la liaison d'applications.

Pour mettre à jour un bundle CICS, cliquez deux fois sur le nom du bundle dans la liste de bundles CICS dans l'éditeur de descripteur de liaison d'applications afin d'ouvrir l'éditeur de manifeste de bundle. Pour mettre à jour une politique dans l'un des bundles référencés, cliquez deux fois sur le nom de la politique dans la liste des politiques dans l'éditeur de descripteur de liaison d'applications afin d'ouvrir l'éditeur de définition de politique. Lorsque vous mettez à jour un bundle CICS, supprimez l'ancienne version du bundle CICS du bundle de liaison d'applications et ajoutez la nouvelle version, comme pour l'éditeur d'application.

Utilisez l'onglet Déploiement de l'éditeur de descripteur de liaison d'applications pour mapper aux types de région de la plateforme cible les bundles CICS de l'application référencée, ainsi que les bundles CICS déployés avec la liaison d'applications. Utilisez le commutateur Commutateur pour basculer entre les types de région et les bundles CICS.
Onglet Déploiement de l'éditeur d'application
L'onglet Déploiement de l'éditeur d'application présente les types de région de la plateforme et les bundles CICS de l'application et de la liaison d'application. Les types de région et les bundles CICS sont respectivement indiqués dans la première et la deuxième colonne.
  • Tous les bundles CICS qui ne 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 bundle CICS puis utilisez les cases à cocher pour spécifier les types de région dans lesquelles ils doivent être déployés.
  • Tous les types de région spécifiés dans une liaison d'applications, mais introuvables dans la version actuelle du projet de plateforme associé à la liaison d'applications, sont marqués par un point d'exclamation. Vérifiez que vous travaillez avec la bonne version du projet de plateforme, et affichez le projet de plateforme de l'éditeur de descripteur 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 plateforme ou que vous êtes passé à une plateforme 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ésélectionnez tous les bundles 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 bundles CICS associés, n'oubliez pas de mettre à jour les numéros de version majeure, mineure ou micro du bundle 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 différentes versions d'applications à l'aide du contrôle des versions. Chaque bundle CICS, bundle d'applications et liaison d'applications 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 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 appliquer les mêmes principes aux bundles 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 bundle. Par exemple, les correctifs de bogue peuvent incrémenter le composant micro de la version, les modifications compatibles incrémentent le composant 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, voir Semantic Versioning (Gestion des versions sémantiques).

Vous devez appliquer une règle de gestion des versions à vos bundles CICS, bundles d'applications et liaisons d'applications pour déployer et gérer des mises à jour dans l'environnement CICS. Vous ne pouvez pas utiliser une version existante d'un bundle d'applications pour déployer de nouvelles versions des bundles CICS pour l'application. Il est également impossible d'utiliser une version existante d'une liaison d'applications avec une nouvelle version d'un bundle d'applications. Vous devez mettre à jour les versions du bundle d'applications et de la liaison d'applications chaque fois que vous mettez à jour les bundles CICS pour l'application.

Lorsque vous modifiez la version d'une application, selon les principes de la gestion de versions sémantiques, la nouvelle version doit refléter la plus grande modification dans un bundle CICS qui est inclus dans l'application. Par exemple, vous pouvez modifier un bundle 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 bundle CICS pour l'application de la Version 1.2.0 à la Version 1.3.0, qui est une modification de version mineure. Le bundle d'applications qui inclut ces deux bundles CICS doit cependant avoir une modification de version mineure. Par conséquent, si l'application était précédemment à la Version 2.5.1, elle doit passer à 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.

Editeur de descripteur d'application en ligne

Utilisez l'éditeur de descripteur d'application en ligne pour afficher les applications qui sont installées sur une plateforme. Vous ne pouvez pas modifier le format de l'application installée à l'aide de cet éditeur.

L'éditeur d'application en ligne est composé de trois onglets : Présentation, Ressources privées et Attributs. La section Actions de l'onglet Présentation dispose de liens vers les autres onglets.

Onglet Présentation de l'éditeur de descripteur d'application en ligne
Utilisez l'onglet Présentation de l'éditeur de descripteur d'application en ligne pour afficher des informations générales sur la version d'application installée, notamment l'ID, la description, le numéro de version, l'état de la version d'application, les bundles CICS qui font partie de l'application et les points d'entrée d'application.
  • Vous pouvez mettre la version d'application à la disposition des appelants via ses points d'entrée d'application à l'aide des boutons Rendre disponible et Rendre indisponible de cet onglet.
  • Vous pouvez activer, désactiver ou supprimer la version d'application à l'aide des boutons Activer et Désactiver de cet onglet.
  • L'option de suppression de la version d'application est disponible comme sélection à partir du bouton Désactiver.
Vous ne pouvez pas utiliser cet éditeur pour modifier le format de l'application installée. Pour modifier le format de l'application installée, modifiez et restituez le projet d'application dans votre espace de travail local de la vue Explorateur de projets, puis exportez et installez la nouvelle version de l'application.

Onglet Ressources privées de l'éditeur de descripteur d'application en ligne.
L'onglet Ressources privées de l'éditeur de descripteur d'application en ligne permet d'afficher les ressources privées qui ont été installées dans vos régions CICS pour la version d'application et les points d'entrée d'application. Sélectionnez l'onglet associé au type de ressource à afficher ; par exemple, ressources PROGRAM ou LIBRARY. Vous pouvez sélectionner l'onglet Ensembles de packages DB2 pour afficher la ressource PACKAGESET associée à l'application. Vous pouvez également sélectionner l'onglet Noms de fichiers de bibliothèque pour afficher les noms de fichiers générés par z/OS pour la concaténation LIBRARY des fichiers des ressources LIBRARY privées. Pour plus d'informations sur les ressources privées, voir Ressources privées pour les versions d'application dans la documentation du produit CICS TS version 5.4.0.

Onglet Attributs de l'éditeur de descripteur d'application en ligne
Utilisez l'onglet Attributs de l'éditeur de descripteur d'application en ligne pour afficher des informations détaillées sur les attributs de la version d'application installée, notamment les répertoires de l'application ainsi que la liaison d'application, le statut d'activation et le statut de disponibilité et la signature de la ressource.