Utilisation des éditeurs pour les plateformes, les applications et les politiques

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

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 principal du 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 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 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'affiche pour que vous puissiez choisir de sauvegarder ou non vos modifications.

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 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 utiliser 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 plateforme

Utilisez l'éditeur de plateforme pour gérer les bundles 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 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 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 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 ces tâches :
  • 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égions 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 bundle

Utilisez l'éditeur d'application et l'éditeur de manifeste de bundle pour mettre à jour vos applications. La rubrique 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 d'application comporte uniquement l'onglet Présentation. La liste des 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'applications pour l'application, et les exporter vers le répertoire de base de la plateforme.

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. Les actions que vous pouvez exécuter sur l'application sont indiquées.
Utilisez l'onglet Présentation 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 bundles CICS de 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 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 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 liaison d'applications

Utilisez l'éditeur de liaison d'applications pour mettre à jour les informations de déploiement de vos applications. La rubrique 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 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.

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 politiques définies par les bundles CICS référencés. Les actions que vous pouvez exécuter sur la liaison d'applications sont indiquées.
Utilisez l'onglet Présentation 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 bundles CICS déployés avec la liaison d'applications.
  • Accès à l'éditeur de manifeste de bundle pour mettre à jour les bundles CICS déployés avec la liaison d'applications.
  • Accès à l'éditeur de manifeste de bundle pour mettre à jour les politiques de l'application.

Pour mettre à jour un bundle 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 bundle. Lors de la mise à jour d'un bundle CICS ou d'une politique, supprimez du bundle de liaisons d'applications l'ancienne version du bundle 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 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.
L'onglet Deployment 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'applications. 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 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 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 plateforme, 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 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éselectionnez 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'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 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 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, voir Livre blanc technique sur la gestion des versions sémantiques.

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. Vous ne pouvez pas utiliser une version existante d'un bundle d'application 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'application avec une nouvelle version d'un bundle d'application. Vous devez mettre à jour les versions du bundle d' application et de la liaison d'application 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'application 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 d'application en ligne

Utilisez l'éditeur 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 liste des actions de l'onglet Présentation dispose de liens vers les autres onglets.

L'onglet Présentation de l'éditeur d'application en ligne présente l'ID, la version et la description de l'application, l'état d'activation et l'état de disponibilité de l'application, les bundles CICS qui sont installés dans le cadre de l'application, et les points d'entrée définis par les bundles CICS. Les actions que vous pouvez exécuter sur l'application sont indiquées.
Utilisez l'onglet Présentation de l'éditeur 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 rendre disponible la version d'application pour les 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 modifier le format de l'application installée à l'aide de cet éditeur. 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.

L'onglet Ressources privées de l'éditeur d'application en ligne possède un panneau Structure qui affiche l'application et un panneau Ressources privée avec des onglets pour les types de ressource privée et les noms de fichier de bibliothèque de l'application.
L'onglet Ressources privées de l'éditeur d'application en ligne permet d'afficher les ressources privées installées dans vos régions CICS pour la version d'application et les points d'entrée d'application. Sélectionnez l'onglet correspondant au type de ressource à afficher. 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.

L'onglet Attributs de l'éditeur d'application en ligne présente les attributs de la version d'application installée, notamment les répertoires de l'application et de la liaison d'application, l'état d'activation et l'état de disponibilité et la signature de ressource.
Utilisez l'onglet Attributs de l'éditeur d'application en ligne pour afficher des informations détaillées sur les attributs de la version d'application installée.