Déploiement d'exemples JCICS

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

Avant de commencer

Vous devez créer des exemples de projets JCICS comme décrit dans Première utilisation des 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 adéquat 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.

Le CICS Explorer SDK fournit une aide pour le déploiement d'applications Java dans un projet de regroupement CICS dans zFS. Un projet de regroupement CICS rassemble un ensemble de regroupements OSGi qui sont logiquement déployés et gérés en tant qu'unité unique. Vous pouvez utiliser l'exemple de projet de regroupement 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 via l'une des méthodes suivantes :
    • Dans la barre de menus Eclipse, cliquez sur Fichier > Nouveau > Exemple.
    • Cliquez sur la flèche vers le bas de l'icône Nouvel assistant et cliquez sur Exemple.
    • Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris et cliquez sur Nouveau > Exemple.
  3. Dans le dossier CICS Java, sélectionnez Exemple de regroupement OSGi 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 du projet par défaut du regroupement CICS est com.ibm.cics.server.examples.
  5. Cliquez sur Terminer. Eclipse crée le projet de regroupement CICS contenant un fichier manifeste et trois ressources. Ces ressources référencent les trois regroupements OSGi. Un fichier programme fait également partie de l'exemple de projet de regroupement que vous pouvez utiliser pour déployer un projet dans CICS et installer un regroupement.
  6. Ouvrez le fichier web.osgibundle pour vérifier son contenu. Ce fichier est au format XML et contient le nom symbolique et la version du regroupement 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 regroupement CICS dans zFS :
    1. Cliquez avec le bouton droit de la souris sur le projet de regroupementCICS et sélectionnez Exporter 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 aucune connexion n'a été configurée précédemment, il peut être nécessaire de créer une connexion à une machine hôte cible.
    4. Accédez au répertoire dans lequel vous voulez déployer le regroupement CICS et cliquez sur Terminer.
    Le regroupement 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, DFH$JVMS, 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 regroupement 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 regroupement en cliquant sur Définitions > Définitions de regroupement. Cette vue répertorie toutes les définitions de regroupement 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 regroupement 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 regroupement dans le nouveau groupe pour changer de répertoire de regroupement afin qu'il corresponde à l'emplacement du regroupement CICS déployé.
  14. Cliquez avec le bouton droit de la souris sur la définition pour installer la ressource de regroupement. Vous pouvez vérifier le regroupement installé dans le statut Activé (ENABLED) en cliquant sur Opérations > Regroupements. Vous pouvez aussi vérifier la liste des regroupements OSGi en cliquant sur Opérations > Java > Regroupements 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 regroupement 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 regroupement CICS dans 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.