Création d'un projet de plug-in

Créez votre application Java™ CICS en tant que projet de plug-in Eclipse qui respecte les spécifications OSGi. La plateforme de services OSGi dispose d'un mécanisme qui permet de développer des applications en utilisant un modèle de composant et en déployant ces applications dans une infrastructure en tant que regroupements OSGi. Le projet de plug-in correspond à un regroupement OSGi et contient tous les fichiers et artefacts requis pour l'application Java CICS, notamment la bibliothèque de classes JCICS pour accéder aux ressources CICS et interagir avec les programmes qui sont rédigés dans d'autres langues. L'application terminée est ensuite ajoutée à un projet de regroupement CICS avant d'être exportée vers le système hôte.

Pourquoi et quand exécuter cette tâche

Cette tâche crée un nouveau projet de plug-in. Vous pouvez laisser les paramètres sur leurs valeurs par défaut, sauf indication contraire. Une fois le projet créé, vous devez éditer le fichier manifeste et ajouter les dépendances de l'API JCICS.

Procédure

  1. Dans la barre de menus Eclipse, cliquez sur Fichier > Nouveau > Projet pour ouvrir l'assistant Nouveau projet.
  2. Sélectionnez Projet de plug-in dans la liste fournie, puis cliquez sur Suivant pour ouvrir l'assistant Nouveau projet de plug-in.
  3. Dans la zone Nom de projet, entrez un nom pour le projet et dans la section Plateforme cible, sélectionnez une infrastructure OSGi, puis standard dans le menu.
    Capture d'écran de l'assistant Nouveau plug-in
    Cliquez sur Suivant.
    La sous-fenêtre Contenu s'affiche.
  4. Dans la zone Version, supprimez ".qualifier" à la fin du numéro de version. Le qualificateur n'est pas actuellement pris en charge.
  5. Dans la zone Environnement d'exécution, sélectionnez le niveau Java qui correspond à l'environnement d'exécution dans votre plateforme cible d'exécution CICS.
    Capture d'écran de la zone Environnement d'exécution avec le menu sélectionné et affichant la liste des options pouvant être sélectionnées.
  6. Décochez la case Générer un activateur et cliquez sur Terminer. Le nouveau projet de plug-in est créé dans la vue Explorateur de packages.
  7. Obligatoire : Obligatoire : Vous devez maintenant éditer le fichier manifeste du plug-in et ajouter les dépendances de l'API JCICS. Si vous n'exécutez pas ces étapes, vous pourrez exporter et installer le regroupement, mais sans pouvoir l'exécuter.
    1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le nom du projet et cliquez sur Outils PDE > Ouvrir le fichier manifeste. Le fichier manifeste s'ouvre dans l'éditeur de fichier manifeste.
    2. Sélectionnez l'onglet Dépendances et dans la section Packages importés, cliquez sur AJOUTER. La boîte de dialogue Sélection de packages s'ouvre.
    3. Sélectionnez le package com.ibm.cics.server et cliquez sur OK. Le package s'affiche dans la liste Packages importés.
    4. Facultatif : Facultatif : Répétez l'étape précédente pour installer le package suivant, si votre application l'exige :
      Tableau 1.
      Package Description
      com.ibm.record API Java des programmes existants qui utilisent IByteBuffer dans l'infrastructure d'enregistrement Java disponible avec VisualAge. Précédemment disponible dans le fichier dfjcics.jar.
      com.ibm.cics.samples Exemples de redirection de System.out et System.err. Remplace le fichier dfjoutput.jar.
    5. Appuyez sur Ctrl +S pour sauvegarder le fichier manifeste.

Résultats

Le nouveau projet de plug-in est créé avec les dépendances API JCICS.

Que faire ensuite

Vous pouvez maintenant créer votre application Java CICS. Si vous êtes novice en termes de développement d'applications Java pour CICS, vous pouvez utiliser les exemples JCICS fournis avec le kit de développement de logiciels CICS Explorer pour commencer.

Remarque : Une fois que vous avez développé votre application, vous devez ajouter une déclaration CICS-MainClass au fichier manifeste et déclarer les classes utilisées dans l'application. Pour plus d'informations, reportez-vous aux liens connexes.

Pour plus d'informations sur le développement de plug-ins, reportez-vous à la section "Guide du développeur de plug-ins de plateforme" dans la documentation d'aide d'Eclipse.

Une fois votre application Java terminée, vous devez la déployer dans un regroupement CICS de zFS. Les regroupements CICS peuvent contenir un ou plusieurs plug-ins et correspondent à l'unité de déploiement de votre application dans CICS.