Déploiement d'exemples JCICS

Vous pouvez utiliser l'exemple de bundle CICS dans CICS Explorer SDK pour déployer les exemples JCICS dans une région CICS.

Avant de commencer

Vous devez créer les trois exemples de projet JCICS, comme indiqué dans Création d'exemples JCICS.

Pourquoi et quand exécuter cette tâche

CICS charge et exécute les applications Java à partir de zFS. Vous devez donc déployer vos applications compilées dans un répertoire adéquat de zFS. Vous pouvez créer un répertoire approprié dans zFS à l'aide de la perspective z/OS dans CICS Explorer. CICS doit disposer d'un accès en lecture et d'exécution à ce répertoire.

CICS Explorer SDK fournit une aide pour le déploiement d'applications Java dans un projet de bundle CICS dans zFS. Un projet de bundle CICS rassemble un ensemble de bundles OSGi qui sont logiquement déployés et gérés en tant qu'unité unique. Vous pouvez utiliser l'exemple de projet de bundle CICS pour déployer les exemples JCICS vers une région CICS.

Procédure

  1. Dans l'environnement de développement intégré d'Eclipse, ouvrez la perspectiveJava.
  2. Ouvrez l'assistant Nouvel exemple en procédant de l'une des façons suivantes :
    • Dans la barre de menus Eclipse, cliquez sur Fichier > Nouveau > Exemple.
    • Cliquez sur la flèche vers le bas de l'icône Nouveau et cliquez sur Exemple.
    • Dans la vue Explorateur de projets ou Explorateur de packages, cliquez avec le bouton droit de la souris et cliquez sur Nouveau > Exemple.
  3. Dans le dossier Exemples CICS > Java, sélectionnez Exemple de bundle d'application CICSExemple OSGi de bundle CICS et cliquez sur Suivant.
  4. Dans la zone Nom de projet, entrez un nom pour le nouveau projet. Par défaut, Eclipse crée un nom correspondant à l'emplacement du dossier d'exemples dans l'espace de travail, suivi du nom de l'exemple. Par exemple, le nom de projet par défaut pour le bundle CICS est com.ibm.cics.server.examples.bundle.
  5. Cliquez sur Terminer. Eclipse crée le projet de bundle CICS contenant un fichier manifeste et trois ressources. Ces ressources référencent les trois bundles OSGi.
  6. Ouvrez le fichier cicsweb.osgibundle afin d'en vérifier le contenu. Ce fichier est au format XML et contient le nom symbolique et la version du bundle OSGi. Il contient aussi le nom d'un exemple de serveur JVM. Ce dernier correspond à l'environnement d'exécution des applications Java de CICS. Lorsque vous créez vos propres applications, vous devez indiquer le nom du serveur JVM cible dans ce fichier.
  7. Déployez le bundle CICS dans zFS :
    1. Cliquez avec le bouton droit de la souris sur le projet de bundle CICS et sélectionnez Exporter le projet de bundle vers le système de fichiers z/OS UNIX.
    2. Sélectionnez Exporter vers un emplacement spécifique dans le fichier système et cliquez sur Suivant.
    3. Saisissez vos données d'identification FTP, le cas échéant. Si vous n'avez pas encore configuré une connexion, vous devez en créer une vers une machine hôte cible.
    4. Accédez au répertoire dans lequel vous voulez déployer le bundle CICS et cliquez sur Terminer.
    Le bundle CICS est déployé dans le répertoire spécifié.
  8. Ouvrez la perspective SM de CICS. Dans la vue Explorateur CICSplex, sélectionnez la région CICS dans laquelle vous voulez exécuter les exemples de programmes JCICS.
  9. Installez la ressource JVMSERVER, DFHJVMS, qui se trouve dans le groupe d'exemples DFH$OSGI. La ressource crée un exemple de serveur JVM dans la région CICS contenant une infrastructure OSGi. Ce nom de ressource correspond au nom du serveur JVM qui a été spécifié dans le manifeste du bundle CICS. Vous pouvez vérifier le statut du serveur JVM en cliquant sur Opérations > Java > Serveurs JVM.
  10. Ouvrez la vue Définitions de bundle en cliquant sur Définitions > Définitions de bundle. Cette vue répertorie toutes les définitions de bundle de la région CICS.
  11. Dans la vue Définitions du groupe de ressources, sélectionnez le groupe DFH$OSGI disponible. Si cette vue n'est pas ouverte, sélectionnez Fenêtre > Afficher la vue pour l'ouvrir dans la perspective Eclipse. La vue Définitions de bundle est filtrée pour afficher la définition de ressource DFH$OSGB.
  12. Copiez la définition de ressource dans un nouveau groupe pour éditer les attributs :
    1. Cliquez avec le bouton droit de la souris sur DFH$OSGB et sélectionnez Copier.
    2. Cliquez avec le bouton droit de la souris n'importe où dans la vue Définitions du groupe de ressources et sélectionnez Coller.
    3. Entrez un nouveau nom de groupe et cliquez sur OK.
  13. Editez la définition de ressource de bundle dans le nouveau groupe pour changer de répertoire de bundle afin qu'il corresponde à l'emplacement du bundle CICS déployé.
  14. Cliquez avec le bouton droit de la souris sur la définition pour installer la ressource de bundle. Vous pouvez vérifier le bundle installé dans le statut Activé (ENABLED) en cliquant sur Opérations > Bundles. Vous pouvez aussi vérifier la liste des bundles OSGi en cliquant sur Opérations > Java > Bundles OSGi.
  15. Pour exécuter les exemples dans un serveur JVM, installez l'exemple de groupe DFH$OSGI dans la région CICS. Ce groupe contient des définitions de ressources pour tous les exemples. Les exemples de ressources de bundle et du serveur JVM ne sont pas installés car vous avez déjà créé des ressources du même nom. Lors de l'installation du groupe, CICS crée les ressources requises pour exécuter les exemples.

Résultats

Vous avez correctement déployé l'exemple de bundle CICS sur zFS et créé les ressources CICS requises pour exécuter les exemples JCICS.

Que faire ensuite

Vous pouvez exécuter les exemples JCICS comme décrit dans Exécution d'exemples JCICS.