Création d'exemples JCICS

Créez les exemples de projet JCICS pour comprendre comment développer les applications Java™ qui peuvent s'exécuter dans CICS.

Procédure

  1. Dans l'environnement de développement intégré d'Eclipse, ouvrez la perspectiveJava.
  2. Affectez la dernière édition de CICS à la plateforme cible pour utiliser les exemples JCICS. Sinon, des erreurs de compilation peuvent se produire lorsque vous créez les exemples dans votre espace de travail.
    1. Cliquez sur Fenêtre > Préférences dans la barre de menus de plan de travail.
    2. Développez Développement du plug-in et cliquez sur Plateforme cible.
    3. Cliquez sur Ajouter pour créer une définition cible.
    4. Cliquez sur Modèle et sélectionnez CICS TS V5.2 dans la liste.
    5. Cliquez sur Suivant dans l'assistant, puis sur Terminer.
    6. Sélectionnez la définition de la cible et cliquez sur OK.
  3. Pour créer un exemple de projet de plug-in, utilisez l'une des méthodes suivantes pour ouvrir l'assistant Nouvel exemple :
    • 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.
  4. Dans le dossier Exemples CICS > Java, sélectionnez Exemples CICS Hello et cliquez sur Suivant.
    Capture d'écran montrant l'assistant avec des exemples disponibles dans le dossier Java.
    • Les exemples d'API CICS montrent comment utiliser les files d'attente de données transitoires, les files d'attente de stockage temporaire, ainsi que les canaux et les zones COMMAREA dans les programmes Java.
    • L'exemple de bundle OSGi CICS montre comment créer un bundle CICS pour effectuer un déploiement sur CICS.
    • Les exemples CICS hello illustrent deux méthodes permettant d'effectuer un simple test Hello World dans CICS.
    • L'exemple Web CICS montre comment utiliser des classes pour interagir avec un navigateur Web.
  5. 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 l'exemple "Hello World" est com.ibm.cics.server.examples.hello.
  6. Cliquez sur Terminer. Eclipse crée le projet de plug-in contenant l'exemple JCICS Hello World en tant que bundle OSGi.
    Conseil : Si le projet n'est pas généré et l'erreur suivante se produit, vérifiez que vous avez correctement effectué l'étape 2 :
    Bundle 'com.ibm.cics.server' cannot be resolved
  7. Développez le projet dans la vue Explorateur de packages.
    Capture d'écran de la vue Explorateur de packages avec l'exemple de projet "Hello World" développé.
    • Le dossier Dépendances du plug-in contient les dépendances du bundle OSGi. Dans cet exemple, le bundle dispose d'une dépendance avec le bundle OSGi contenant JCICS. Ces informations sont aussi capturées dans le fichier manifeste du projet.
    • Le dossier src contient la source Java pour les exemples. Vous pouvez naviguer dans les fichiers source pour voir les classes JCICS qui sont utilisées et recourir à l'aide contextuelle pour rechercher une classe spécifique. Vous pouvez également ouvrir la vue Javadoc pour afficher les détails d'API pour le contenu sélectionné, par exemple une méthode ou une classe.
    • Le dossier META-INF contient le fichier manifeste du projet. Ce fichier contient les en-têtes OSGi pour décrire le bundle OSGi.
  8. Créez des projets de plug-in pour l'API CICS et les exemples Web CICS en utilisant l'assistant Nouvel exemple. Vous pouvez afficher la source Java pour comprendre comment les classes JCICS sont utilisées dans les programmes et les applications Web.

Résultats

Vous avez créé trois projets de plug-in dans Eclipse pour les exemples JCICS. Ces projets contiennent des informations de mise en package de bundles OSGi, y compris les dépendances de plug-in et les environnements Java cible.