Vous pouvez utiliser l'exemple de bundle CICS dans CICS Explorer SDK pour déployer
les exemples JCICS dans une région CICS.
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
- Dans l'environnement de développement intégré d'Eclipse, ouvrez la perspectiveJava.
- Ouvrez l'assistant Nouvel exemple en procédant de l'une des façons suivantes :
- Dans la barre de menus Eclipse, cliquez sur .
- 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 .
- Dans le dossier , sélectionnez Exemple de bundle d'application CICSExemple OSGi de bundle CICS et cliquez sur Suivant.
- 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.
- 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.
- 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.
- Déployez le bundle CICS dans zFS :
- 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.
- Sélectionnez Exporter vers un emplacement spécifique dans le fichier système et cliquez sur Suivant.
- 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.
- 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é.
- 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.
- 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
.
- Ouvrez la vue Définitions de bundle en cliquant sur . Cette vue répertorie toutes les définitions de bundle de la région CICS.
- 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 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.
- Copiez la définition de ressource dans un nouveau groupe pour éditer les
attributs :
- Cliquez avec le bouton droit de la souris sur DFH$OSGB et sélectionnez Copier.
- Cliquez avec le bouton droit de la souris n'importe où dans la vue Définitions du groupe de ressources
et sélectionnez Coller.
- Entrez un nouveau nom de groupe et cliquez sur OK.
- 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é.
- 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 . Vous pouvez aussi vérifier la liste des bundles OSGi en cliquant sur .
- 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.