Mise à jour du fichier manifeste du projet de plug-in

Lorsque vous développez une nouvelle application JCICS ou que vous packagez une application existante dans un projet de plug-in, vous devez mettre à jour le fichier manifeste du projet et inclure une déclaration CICS-MainClass.

Pourquoi et quand exécuter cette tâche

La déclaration CICS-MainClass permet de déclarer les classes pouvant être appelées par d'autres applications CICS extérieures au serveur JVM. N'utilisez pas de règles d'activation lentes pour les bundles OSGi qui déclarent une classe principale CICS. CICS active les bundles OSGi dès qu'ils sont démarrés dans l'infrastructure OSGi. Vous devez ajouter la déclaration manuellement dans le fichier manifeste.

Procédure

  1. Si le fichier manifeste n'est pas déjà ouvert dans l'éditeur, cliquez avec le bouton droit de la souris sur le nom du projet dans la vue Explorateur de packages 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 MANIFEST.MF. Le contenu du fichier s'affiche.
  3. Ajoutez la déclaration suivante au fichier manifeste : CICS-MainClass: nom_app.nom_classe où :
    nom_app
    Correspond au nom du regroupement indiqué dans le fichier manifeste.
    nom_classe
    Correspond au nom de la classe utilisée dans l'application. Si plusieurs classes sont utilisées, répétez l'élément nom_app.nom_classe en le séparant par une virgule.

    Facultatif : Vous pouvez utiliser des alias dans la déclaration CICS-MainClass ; par exemple, la déclaration CICS-MainClass: Table_application.CreateTable;alias=table1 attribue l'alias table1 à CICS-MainClass Table_application.CreateTable. Lorsque vous définissez le programme dans CICS, vous utilisez le nom d'alias, table1, au lieu du nom de classe. Un alias est utile si vous disposez de plusieurs versions du même programme, chacun avec le même nom de classe. En utilisant les alias, vous pouvez identifier les différentes versions.

    La capture d'écran suivante affiche un exemple de fichier manifeste pour les exemples Hello CICS. L'exemple d'application contient deux classes : HelloCICSWorld et HelloWorld, qui sont déclarés dans le fichier manifeste de la déclaration CICS-MainClass. Ces classes peuvent être appelées par des applications extérieures au serveur JVM.

    Capture d'écran d'un manifeste affichant les attributs et les valeurs.

  4. Lorsque vous avez ajouté toutes les déclarations de classe, appuyez sur Ctrl +S pour sauvegarder le fichier manifeste.

Résultats

Vous pouvez maintenant ajouter le projet de plug-in à un regroupement CICS et le déployer dans zFS. Les regroupements CICS peuvent contenir un ou plusieurs plug-ins et correspondent à l'unité de déploiement de votre application dans CICS.