Déploiement d'un bundle CICS

Vous pouvez déployer un bundle CICS en l'exportant directement vers un système de fichiers z/OS UNIX System Services (z/OS UNIX) à partir de CICS Explorer. Utilisez une ressource BUNDLE pour localiser le bundle dans zFS et créez dynamiquement les ressources depuis le bundle de la région CICS.

Avant de commencer

Vous devez vérifiez que vous disposez des droits d'accès aux fichiers zFS adéquats afin que les bundles exportés à partir de CICS Explorer puissent être copiés dans le répertoire de base de la plateforme ou le répertoire cible sur zFS et qu'ils puissent être lus par toutes les régions CICS de la plateforme ou par la région CICS appropriée.
  • Définissez le masque de mode de création de fichier pour le démon FTP z/OS afin que le propriétaire ait des droits d'accès en écriture et que le groupe ait des droits d'accès en lecture. Pour configurer ces droits, utilisez l'instruction UMASK dans le fichier de configuration FTP.DATA.
  • Le cas échéant, si vous utilisez également les entrées de la liste de contrôle d'accès (ACL) USS (UNIX System Services) pour contrôler la sécurité, veillez à ce que les listes de contrôle d'accès par défaut soient héritées du répertoire de base de la plateforme dans zFS ; par exemple, /var/cicsts/CICSplex/plateforme1, où CICSplex est ne nom de votre CICSplex et plateforme1, le nom de votre plateforme.

Pourquoi et quand exécuter cette tâche

Une fois que vous avez créé un bundle CICS dans CICS Explorer, vous devez l'exporter vers un système de fichiers z/OS UNIX afin de le rendre disponible dans CICS. Vous pouvez déployer un projet de bundle CICS de façon individuelle ou avec un bundle de gestion. Par exemple, si le projet de bundle fait partie d'une application à déployer sur une plateforme, vous pouvez le déployer avec le bundle d'applications en exportant le projet d'application. La procédure suivante explique comment déployer individuellement un bundle CICS.

Remarque : Si vous ne disposez pas des droits permettant de déployer le projet de bundle CICS directement sur un système de fichiers z/OS, vous pouvez l'exporter sous forme de fichier compressé vers le système de fichiers local. Pour plus d'informations, reportez-vous à la rubrique Exportation d'un projet de bundle CICS vers le système de fichiers local. Toutefois, cette option ne s'applique pas à un projet de bundle CICS qui contient un bundle OSGi.

Procédure

  1. Accédez à l'explorateur de projet.
  2. Cliquez avec le bouton droit de la souris sur le projet de bundle CICS puis cliquez sur Exporter le projet de bundle vers le système de fichiers z/OS UNIX. Vous pouvez à présent choisir d'exporter vers le répertoire de base de votre plateforme ou vers un emplacement spécifique du système de fichiers.
  3. Cliquez sur l'un des boutons suivants pour indiquer si l'application doit être exportée :
    • Remarque : La case à cocher en bas de la page contrôle si votre paramètre est conservé en mémoire pour ce projet.
    • Exportez vers le répertoire de base d'une plateforme. Si vous sélectionnez cette option, cliquez sur Suivant, puis effectuez les étapes suivantes :
      1. Sélectionnez l'application à exporter (la zone est préremplie avec la sélection en cours, le cas échéant).
      2. Sélectionnez la plateforme de destination de l'exportation.
      3. Pour remplacer des variables du projet de bundle CICS par les valeurs présentes dans le fichier variables.properties, cochez la case Résoudre les variables à l'aide de fichiers de propriétés.
      4. Cliquez sur Suivant.
      5. Sélectionnez la connexion z/OS à utiliser pour l'exportation. Lorsque vous effectuez une sélection, une connexion est établie et l'assistant recherche les bundles et sous-répertoires d'application du répertoire d'accueil de la plateforme qui utilisent cette connexion.
      6. Cliquez sur Terminer.
    • Exportez vers un emplacement spécifique du système de fichiers. Si vous sélectionnez cette option, cliquez sur Suivant.
  4. Dans la zone Connexion, sélectionnez une connexion z/OS appropriée au système de fichiers distant. Vous pouvez cliquer sur l'icône de connexion pour utiliser la connexion actuellement affichée, cliquer sur la flèche pour en sélectionner une autre ou créer une nouvelle connexion. Les options prises en charge sont la connexion z/OS FTP, la connexion z/OS Remote System (RSE) et la connexion z/OSMF.
    Remarque :
  5. Dans la zone Répertoire parent, indiquez le nom du répertoire de système de fichiers z/OS UNIX à utiliser comme cible pour le transfert. Notez qu'il peut s'agir d'un nouveau répertoire ou d'un répertoire existant. Lorsque vous entrez le nom d'un dossier de répertoires, l'arborescence des répertoires est actualisée et ce dossier apparaît en tant que racine. Si vous cliquez deux fois sur un dossier, celui-ci devient la racine de l'arborescence. Vous pouvez également effectuer une sélection dans l'arborescence et naviguer vers le répertoire.

    La zone Répertoire de bundle contient le répertoire cible du bundle exporté. Par défaut, le nom du répertoire de bundle utilise l'ID et la version du bundle. Si vous n'avez pas spécifié d'ID ou de version, le nom du bundle est utilisé. Vous pouvez remplacer le nom du répertoire.

  6. Facultatif : Cochez la case Effacer le contenu du répertoire de bundle pour supprimer tous les dossiers et fichiers du répertoire cible avant de procéder au transfert de fichiers. Si vous ne cochez pas cette case, et qu'un dossier portant ce nom existe déjà, l'exportation ne s'exécute pas.
  7. Pour remplacer des variables du projet de bundle CICS par les valeurs présentes dans le fichier variables.properties, cochez la case Résoudre les variables à l'aide de fichiers de propriétés.
  8. Cliquez sur Terminer.

Résultats

Le projet de bundle est exporté vers le répertoire cible z/OS UNIX.

Dans le cas d'un projet OSGi, si une plage de versions a été définie lors de l'ajout de la référence au bundle OSGi dans le projet de bundle CICS, la version la plus élevée du projet OSGi est incluse dans cette plage.

Que faire ensuite

Définissez et activez une ressource BUNDLE pour le bundle CICS. Vous pouvez créer une définition en ouvrant la vue Définitions de bundles. Lorsque la ressource BUNDLE est activée, CICS lit le manifeste situé dans le répertoire de bundle et crée dynamiquement les ressources CICS. Il vérifie également que des dépendances sont présentes dans la région CICS. Pour plus d'informations relatives aux ressources de bundle, voir Ressources BUNDLE dans la documentation du produit CICS TS version 5.4.0.

Remarque : Lorsque vous avez créé et déployé votre projet de bundle CICS à l'aide de CICS Explorer, vous devez assurer la bonne gestion de la source du projet. Le bundle CICS ne peut pas être reconstruit à partir des données exportées dans zFS, et une défaillance de votre poste de travail peut générer une perte des données. Vous pouvez utiliser la fonction Exporter de CICS Explorer pour exporter le projet et le contrôler dans un système de gestion de code source.