Ajout de ressources dans un projet de bundle CICS

Lorsque vous ajoutez des définitions de ressources dans un projet de bundle CICS, CICS crée dynamiquement des ressources pour que vous puissiez déployer et installer un bundle dans la région CICS.

Avant de commencer

Vous devez créer un projet de bundle CICS avant de pouvoir y ajouter des ressources. Pour plus d'informations, voir Création d'un projet de bundle CICS.

Pourquoi et quand exécuter cette tâche

Certaines caractéristiques des ressources CICS changent car elles sont définies dans un bundle CICS et dynamiquement créées dans le cadre du déploiement d'un bundle. Les cycles de vie des ressources CICS qui sont créées de cette manière ne peuvent pas être gérés indépendamment d'une ressource de bundle. Ils doivent être gérés par le biais d'un bundle CICS. En raison de l'interdépendance entre le cycle de vie d'un bundle et d'une ressource, les architectes d'applications doivent attentivement examiner l'ensemble des ressources d'une application dont le cycle de vie doit être lié à celui d'un bundle CICS. Pour en savoir plus sur les éventuelles implications liées à la définition de ressources dans des bundles CICS, voir Caractéristiques de ressources regroupées.

Vous pouvez référencer un ou plusieurs bundles CICS dans un bundle d'applications. Ce conditionnement de votre application vous permet de déployer une application et ses bundles en tant qu'entité unique dans CICS, tout en simplifiant la mise à jour et la gestion de l'application dans CICS. Un bundle CICS peut être installé dans des régions CICS par plusieurs applications seulement si celles-ci sont éligibles pour la gestion de versions multiples.

Les applications déployées sur des plateformes qui utilisent les ressources CICS prises en charge en tant que ressources privées, combinées avec d'autres ressources conçues pour des applications et des ressources importées, sont éligibles pour la gestion de versions multiples. Les ressources suivantes sont prises en charge dans des applications gérant des versions multiples :
  • Ressources PROGRAM définies dans des bundles CICS faisant partie de l'application
  • Ressources LIBRARY définies dans des bundles CICS faisant partie de l'application
  • Règles
  • Instructions de points d'entrée d'application
  • Toute ressource définie comme une dépendance, ou importation, pour l'application

Un bundle CICS qui contient d'autres types de ressource ne peut pas être inclus à d'autres applications installées dans les mêmes régions CICS de la plateforme et vous ne pouvez pas l'ajouter à la plateforme s'il a déjà été installé pour une application. Si votre application a besoin d'une ressource non prise en charge pour la gestion de versions multiples et qui a déjà été utilisée dans un bundle CICS ayant été installé dans la région cible de la plateforme, créez un nouveau projet de bundle CICS. Déclarez la ressource comme dépendance pour le nouveau bundle CICS en spécifiant une importation dans le fichier manifeste. Incluez ensuite le nouveau projet de bundle CICS à votre projet d'application. Pour obtenir des instructions sur la déclaration d'une ressource comme dépendance, voir Définition des dépendances de bundle.

Lorsque vous définissez une ressource TRANSACTION dans un bundle CICS et que vous déployez le bundle CICS dans le cadre d'une application ou que vous l'ajoutez à une plateforme, l'installation automatique du programme initial pour la transaction n'est pas pris en charge. Pour une ressource TRANSACTION définie dans un bundle CICS déployé dans le cadre d'une application, vous devez définir et déployer la ressource PROGRAM pour le programme initial de la transaction dans le cadre de la même application. Pour une ressource TRANSACTION définie dans un bundle CICS déployé avec une plateforme, vous devez définir et déployer la ressource PROGRAM pour le programme initial de la transaction de l'une des manières suivantes :
  • Dans un bundle CICS déployé avec la plateforme.
  • Dans le cadre d'une application déployée sur la plateforme.
  • Dans les régions CICS faisant partie de la plateforme, à l'aide d'un bundle CICS autonome, le CSD CICS ou le référentiel de données CICSPlex SM.

Pour définir une ressource dans un projet de bundle CICS, procédez comme suit :

Procédure

  1. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le projet de bundle CICS et cliquez sur Nouveau.
  2. Sélectionnez une ressource du menu à ajouter, par exemple : un programme, une bibliothèque, une transaction ou la définition d'une mappe d'identificateur URI.
    Conseil : Les bundles CICS prennent en charge les ressources dont les noms affichent une casse mixte et qui sont pris en charge dans CICS. Toutefois, votre système de fichiers risque de ne pas autoriser la présence de fichiers portant un nom identique, mais avec une casse différente, dans le même projet de bundle CICS. Si vous exigez des noms de ressources en double utilisant des casses différentes, définissez ces ressources dans des projets de bundles CICS distincts.
  3. Renseignez les zones obligatoires dans l'assistant.
    1. Pour un sous-ensemble de ressources CICS, vous pouvez ajouter une opération d'application à condition que la ressource soit un point d'entrée dans une application.
    2. Pour un serveur JVM, vous pouvez choisir de créer un profil JVM à l'aide de l'un des modèles fournis, OSGi, Axis2 ou Liberty, d'utiliser un profil JVM existant dans le bundle CICS, ou d'importer un profil JVM existant dans le bundle CICS depuis un autre emplacement de l'espace de travail ou à partir du système de fichiers local. Une fois que vous avez exécuté l'assistant, éditez le profil JVM en fonction de votre configuration système en suivant les instructions de la section Edition de ressources définies dans une projet de bundle CICS.
    3. Pour un pipeline, vous pouvez choisir de créer un fichier de configuration de pipeline à l'aide de l'un des exemples de fichier de configuration de pipeline fournis par CICS, ou d'importer un fichier de configuration existant à partir du système de fichiers local ou de l'espace de travail local. Une fois que vous avez exécuté l'assistant, éditez le fichier de configuration de pipeline pour y ajouter des gestionnaires de message, des programmes de traitement d'en-tête et des gestionnaires d'application en suivant les instructions de la section Edition de ressources définies dans une projet de bundle CICS.
    4. Pour un service Web, vous importez un fichier de liaison de service Web à partir du système de fichiers local ou de l'espace de travail local pour créer la définition WEBSERVICE. Vous pouvez choisir d'importer un document WSDL ou un fichier archive WSDL à conditionner dans le bundle, et pour un fournisseur de service, vous pouvez cocher la case pour inclure une définition PROGRAM dans le bundle. Notez que le service Web est créé avec le paramètre par défaut stipulant que la validation complète de messages SOAP n'est pas obligatoire, mais vous pouvez modifier ce paramètre dans l'éditeur de ressource ou dans CICS une fois que la ressource a été installée.
    5. Une fois que vous avez créé une définition WEBSERVICE, vous pouvez cliquer dessus avec le bouton droit de la souris et lancer un assistant afin de générer les définitions URIMAP pour le service Web et de créer une transaction d'alias :
      • Le chemin pour la définition URIMAP est pré-rempli en fonction du fichier de liaison de service Web, mais vous pouvez entrer un autre chemin si nécessaire.
      • Le nom d'hôte et le numéro de port pour la définition URIMAP sont pré-remplis en fonction du fichier de liaison de service Web. Si le nom d'hôte ne peut pas être extrait, CICS Explorer affiche un message d'avertissement et vous devez entrer une valeur dans la zone Hôte. Si le numéro de port ne peut pas être extrait, CICS Explorer fournit la valeur par défaut 80 ou 443, en fonction du schéma d'URI.
      • La transaction d'alias par défaut est CPIH, mais vous pouvez la modifier et cocher la case pour générer une définition de transaction. Notez que des définitions de transaction ne seront pas générées pour CPIH ou CPIQ, même si la case est cochée. Les autres noms de transaction commençant par C sont réservés pour CICS.
      • Pour faire d'une ressource URIMAP un point d'entrée d'application, vous pouvez ouvrir l'éditeur de manifeste de bundle CICS et accéder à l'onglet Points d'entrée, puis ajouter un point d'entrée en spécifiant un nom d'opération unique, un type de ressource URIMAP et un nom de ressource URIMAP.
    6. Pour une ressource URIMAP, vous pouvez créer un fichier de configuration URIMAP avec la boîte de dialogue de nouvelle définition de mappe URI. Indiquez l'hôte et le chemin, et sélectionnez l'utilisation.
      • Pour une définition URIMAP qui utilise un fichier HFS afin de fournir une réponse statique, le fichier doit être conditionné dans le bundle CICS avec la ressource URIMAP. Indiquez un chemin de fichier relatif par rapport au répertoire racine du bundle CICS. Pour un chemin de fichier relatif, vous ne devez pas utiliser une barre oblique au début du chemin. Des chemins d'accès absolus peuvent être utilisés, mais ils sont vivement déconseillés.
      • Sélectionnez l'utilisation :
        • Pour créer une définition URIMAP pour CICS en tant que serveur HTTP, sélectionnez Serveur. Ce type de définition URIMAP est utilisé pour mapper l'URI d'une demande HTTP entrante à partir d'un client Web à des ressources CICS. Une réponse générée par l'application ou une réponse statique peut être fournie.
        • Pour créer une définition URIMAP pour CICS en tant que client HTTP, sélectionnez Client. Ce type de définition URIMAP est utilisé lorsque CICS effectue une demande pour une ressource HTTP sur un serveur pour vous permettre d'éviter l'identification de l'URI dans votre programme d'application.
        • Pour créer une définition URIMAP pour un service Web, sélectionnez Pipeline. Ce type de définition URIMAP est utilisé pour une demande de service Web entrante, c'est-à-dire une demande par laquelle un client appelle un service Web dans CICS. L'URI de la demande entrante est associé aux ressources WEBSERVICE et PIPELINE qui spécifient le traitement à effectuer sur le message.
        • Pour créer une définition URIMAP pour un flux Atom, sélectionnez Atom. Ce type de définition URIMAP est utilisé pour une demande entrante pour des données mises à disposition par CICS en tant que flux Atom. La définition URIMAP mappe l'URI de la demande à une définition de ressource ATOMSERVICE qui définit un document Atom.
        • Pour créer une définition URIMAP pour une application Web s'exécutant sur un serveur JVM, sélectionnez Serveur JVM. Ce type de définition URIMAP est utilisé pour mapper des demandes d'application entrantes à une transaction CICS. Si aucune définition URIMAP ne correspond à la demande entrante, CICS utilise la transaction CJSA.
        • Pour configurer la définition URIMAP de sorte qu'une réponse statique soit fournie, sélectionnez Fichier, puis Fichier HFS ou Nom de modèle. L'attribut d'utilisation est défini sur USAGE(SERVER).
      • Pour faire d'une ressource URIMAP un point d'entrée d'application, cochez la case Créer un point d'entrée d'application et entrez un nom d'opération unique. Vous pouvez également ouvrir l'éditeur de manifeste de bundle CICS et accéder à l'onglet Points d'entrée, puis ajouter un point d'entrée en spécifiant un nom d'opération unique, un type de ressource URIMAP et un nom de ressource URIMAP.
  4. Cliquez sur Terminer.
  5. Pour afficher et modifier les attributs d'une ressource immédiatement après sa création, cochez la case Ouvrir un éditeur pour ouvrir l'éditeur de ressources lorsque vous avez fini d'utiliser l'assistant. Pour ouvrir l'éditeur ultérieurement, vous pouvez ouvrir l'éditeur de ressources dans la vue Explorateur de projets.

Résultats

Une définition de ressource est créée dans le projet de bundle CICS et le manifeste de bundle est mis à jour.

Que faire ensuite

Pour modifier une ressource dans l'éditeur de ressources, suivez les instructions dans la rubrique Edition de ressources définies dans une projet de bundle CICS.

Une fois votre définition de ressource terminée, vous pouvez déployer le projet de bundle CICS dans zFS ou placer le bundle dans un package pour le déployer avec un bundle d'applications ou de plateformes. Pour plus d'informations, voir Déploiement d'un bundle CICS.