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
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 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.

- 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.

- 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.
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 pour basculer entre les types de région et les bundles
CICS.

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.

- 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.

- 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.


- 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.

- 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.

