Définition de dépendances de bundle

Définissez les dépendances, ou importations, d'un bundle CICS dans les éléments <import> du fichier de manifeste de bundle (cics.xml).

Pourquoi et quand exécuter cette tâche

Si vous avez besoin qu'une ressource CICS soit disponible dans la région CICS, mais que vous ne souhaitez pas que le cycle de vie de la ressource soit lié au cycle de vie du bundle CICS, vous pouvez ajouter la ressource en tant que dépendance du bundle CICS. Par exemple, si le bundle CICS contient des ressources pour un service Web, vous pouvez indiquer que la ressource PIPELINE utilisée par le service Web doit être disponible dans la région CICS. Lorsque vous installez le bundle CICS, CICS vérifie qu'une ressource du type spécifié avec le nom spécifié est installée et activée dans la région CICS.

Vous pouvez sélectionner l'action exécutée par CICS si une ressource spécifiée dans un élément <import> n'est pas présente dans la région CICS. Par exemple, l'installation du bundle peut échouer, ou aboutir mais avec un message d'avertissement. Vous pouvez rendre les importations facultatives de sorte que la ressource BUNDLE s'installe toujours à l'état activé, même lorsque la dépendance ne correspond pas.

Dans un bundle CICS conditionné dans le cadre d'une application déployée sur une plateforme, des ressources publiques ou privées peuvent être définies en tant que dépendances, y compris des programmes privés qui sont installés automatiquement par une application. CICS recherche d'abord une ressource privée avec le type et le nom spécifiés dans la même application que le bundle CICS qui contient l'élément <import> dans le fichier de manifeste de bundle. Si plusieurs versions de l'application sont installées, le contexte d'application en cours détermine la version de la ressource privée qui est importée. Si la ressource est introuvable en tant que ressource privée pour l'application, CICS recherche une ressource publique dans la région CICS qui correspond aux type et nom spécifiés, et importe la ressource. Vous ne pouvez pas importer des ressources privées à partir d'autres applications.

Procédure

  1. Accédez au dossier META-INF du bundle avec lequel vous voulez travailler.
  2. Cliquez deux fois sur le fichier manifeste cics.xml. L'éditeur de manifeste de bundle s'ouvre et affiche toutes les ressources actuelles requises pour ce bundle, ainsi que l'ID et la version du bundle.
  3. Cliquez sur Ajouter. La boîte de dialogue Propriétés d'importation s'ouvre.
  4. Saisissez le type de ressource dans la liste des types de ressource CICS. Appuyez sur Ctrl + Espace pour afficher l'aide du contenu.
  5. Entrez le nom de la ressource requise.
  6. Indiquez si l'importation est obligatoire ou facultative avant que la ressource BUNDLE puisse être activée. Le comportement par défaut est que l'importation est obligatoire et que la ressource BUNDLE ne peut être activée tant que la dépendance ne correspond pas. Si vous sélectionnez Facultative, la ressource BUNDLE est installée même si la dépendance ne correspond pas dans la région CICS. Indiquez si un message d'avertissement doit être émis ou non si la dépendance n'est pas satisfaite.
  7. Cliquez sur OK. La ressource est ajoutée à la liste des ressources importées requises par ce bundle.
  8. Cliquez sur Enregistrer.

Résultats

Vous avez défini les ressources CICS requises par le bundle CICS.

Que faire ensuite

Vous pouvez ajouter des ressources CICS au projet de bundle. Ces ressources sont créées dynamiquement lorsque la ressource BUNDLE est installée dans la région CICS.