Génération de fichiers d'interface de service à partir de l'application IMS

Modifier en ligne

Utilisez les outils de service d'entreprise pour générer les artefacts nécessaires pour permettre à votre application IMS PL/I ou COBOL existante de s'exécuter en tant que service Web dans l'environnement d'exécution IMS Enterprise Suite SOAP Gateway.

Avant de commencer

Pour générer les artefacts nécessaires à l'activation d'une application IMS PL/I ou COBOL existante pour l'environnement IMS Enterprise Suite SOAP Gateway, vous devez disposer d'un fichier d'inclusion PL/I ou d'un copybook COBOL qui décrit le format des messages d'entrée et de sortie pour l'application IMS.

A propos de cette tâche

Étant donné que les artefacts générés par l'assistant Enterprise Service Tools (le fichier WSDL, le fichier corrélateur et le fichier d'inclusion PL/I ou le fichier de copybook COBOL contenant le pilote de service Web et les programmes de conversion XML d'exécution) doivent être transférés vers un système z/OS®, vous pouvez utiliser la perspective Projets z/OS et un projet z/OS local dans Developer for z/OS pour aider à cette tâche.

Pour générer des artefacts de services Web pour l'environnement d'exécution IMS Enterprise Suite SOAP Gateway :
  1. Pour ouvrir la perspective Projets z/OS, cliquez sur l'icône Ouvrir la perspective Ouvrez le bouton de la barre d’outils Perspective, puis double-cliquez sur Projets z/OS.
  2. Créez un projet z/OS local:
    1. Cliquez avec le bouton droit de la souris sur la vue Projets d' z/OS, puis sélectionnez Nouveau > Projet d' z/OS s locales. La fenêtre Nouveau projet local s'ouvre.
    2. Tapez le nom du projet.
    3. Dans la zone Groupe de propriétés, sélectionnez l'une des options suivantes :
      • Sélectionnez un groupe de propriétés à associer au projet Sélectionnez cette option, puis un groupe de propriétés pour le nouveau projet. Vous pouvez trier la liste en cliquant sur les en-tête de table. Pour inverser l'ordre de tri, cliquez à nouveau sur l'en-tête.
      • Créez un groupe de propriétés et associez-le au projet. Cliquez sur Terminer pour modifier le groupe de propriétés. Sélectionnez cette option pour créer un groupe de propriétés pour le projet. Entrez un nom pour le groupe dans la zone Nom .
      • N'associez pas le projet à un groupe de propriétés. Sélectionnez cette option pour créer le projet sans l'associer à un groupe de propriétés.
    4. Cliquez sur Terminer. Si vous créez un groupe de propriétés, l'éditeur de groupe de propriétés s'ouvre.
  3. Vérifiez que la vue Navigator est ouverte dans la perspective Projets z/OS ; un onglet Navigator doit être visible sur l'interface. Si la vue Navigator n'est pas ouverte, procédez comme suit pour ouvrir la vue Navigator :
    1. Dans la barre de menus de l'espace de travail, sélectionnez Fenêtre > Afficher la vue > Autre. L'assistant Afficher la vue s'ouvre.
    2. Dans l'assistant Afficher la vue , développez Général, sélectionnez Navigatoret cliquez sur OK.
    La vue Navigator s'ouvre.
  4. Importez dans votre projet local le fichier (soit le fichier d'inclusion PL/I, soit le fichier de copybook COBOL ), qui contient les structures de données qui décrivent les structures de données d'entrée et de sortie de votre application IMS. Le fichier importé doit également être visible dans la vue Navigator.
    Les fichiers pouvant être utilisés pour l'importation dans votre projet local sont les suivants:
    • COBOL. cbl,.cpy,.cob, et.ccp
    • PL/I. pli,.inc, et.mac
  5. Démarrez le tableau de bord de l'assistant Enterprise Service Tools à partir de la vue Navigator :
    Remarque : les étapes suivantes concernent uniquement l'assistant Créer un nouveau service (de bas en haut). Pour plus d'informations, reportez-vous à Contextes de démarrage des assistants de service unique lorsque vous exécutez l'assistant en dehors de la perspective Outils d'entreprise.
    1. Dans la vue Navigator, cliquez avec le bouton droit de la souris sur le fichier source importé ( PL/I ou COBOL ) qui contient les structures de données d'entrée et de sortie de l'application IMS.
    2. Sélectionnez Activer le service Web d'entreprise.
    L'assistant Tableau de bord de l'assistant Enterprise Service Tools s'ouvre.
  6. Lancez l'assistant Créer une nouvelle interface de service (ascendant):
    1. Dans l'assistant Tableau de bord de l'assistant Enterprise Service Tools , effectuez les sélections suivantes, puis cliquez sur Démarrer:
      • Exécution: IMS Enterprise Suite SOAP Gateway
      • Scénario: Création d'une nouvelle interface de service (ascendant)
      • Type de conversion: Conversion XML compilée
      L'assistant Créer une nouvelle interface de service (ascendant) s'ouvre.
  7. Sur la première page de l'assistant (intitulée Structures de langage):
    1. Cliquez sur le bouton Change PL/I Preferences ou Change COBOL Preferences. La fenêtre des préférences s'ouvre et affiche les options PL/I ou COBOL dans le volet de droite.
    2. Dans l'onglet Général de la fenêtre PL/I ou COBOL développez la zone de liste Plateforme, sélectionnez z/OS, vérifiez ou modifiez les autres entrées qui s'appliquent à votre système z/OS, puis cliquez sur OK.
    3. Dans l'onglet Structure linguistique de la demande, sélectionnez la structure linguistique de haut niveau ( PL/I ou COBOL ) qui est la structure d'entrée de votre application IMS. Par défaut, la première structure définie dans le fichier source du programme est sélectionnée.
    4. Dans l'onglet Structure linguistique de la réponse, sélectionnez la structure linguistique de haut niveau ( PL/I ou COBOL ) qui est la structure d'entrée de votre application IMS. Par défaut, la première structure définie dans le fichier source du programme est sélectionnée.
    5. Cliquez sur Suivant.
  8. Sur la deuxième page de l'assistant (intitulée Options de génération):
    1. Dans l'onglet Convertisseurs XML , effectuez les sélections suivantes:
      • Page de codes hôte: Sélectionnez la page de codes utilisée par l'hôte.
      • Page de codes de la demande: 1208 Unicode, UTF-8
      • Page de codes de réponse: 1208 Unicode, UTF-8
      Remarque: A l'heure actuelle, l'environnement d'exécution IMS Enterprise Suite SOAP Gateway prend uniquement en charge UTF-8.
    2. Dans la zone d'entrée Emplacement du service (URI du noeud final) de l'onglet WSDL et XSD , remplacez le nom d'hôte et le nom de port par l'emplacement de la IMS Enterprise Suite SOAP Gateway, vérifiez ou modifiez les autres entrées qui s'appliquent à votre système z/OS , puis cliquez sur Suivant.
      Remarque: cet URI spécifie l'adresse du service Web.
  9. Sur la troisième page de l'assistant (intitulée IMS Enterprise Suite SOAP Gateway Fournisseur de services):
    1. Dans l'onglet IMS , spécifiez les propriétés de corrélateur qui doivent être spécifiées pour votre environnement IMS Enterprise Suite SOAP Gateway . En particulier, dans la zone d'entrée Conteneur de fichier, indiquez le dossier et le sous-dossier dans lesquels vous souhaitez que le fichier de corrélateur soit généré.
      Remarque : vous pouvez générer des artefacts directement dans le z/OS UNIX System Services système de fichiers (voir Génération d'artefacts à distance ).
    2. Cliquez sur Suivant.
  10. Sur la quatrième page de l'assistant (intitulée Sélection de fichier, de fichier ou de membre):
    1. Dans l'onglet Convertisseurs XML , spécifiez les valeurs suivantes:
      • Converter file container: dossier et sous-dossier dans lesquels vous souhaitez que les programmes de conversion soient créés.
      • Nom du fichier du pilote de convertisseur: nom du fichier dans lequel vous souhaitez que les programmes de convertisseur soient générés.
      Remarque: assurez-vous que la case Générer tout au pilote est cochée. Ainsi, tous les programmes de service Web générés (pilote, convertisseur de demande et convertisseur de réponse ) sont placés dans le même fichier. Vous pouvez générer des artefacts directement sur MVS (voir Générer des artefacts à distance ).
    2. Dans l'onglet WSDL et XSD , spécifiez les paramètres suivants:
      • Conteneur de fichier WSDL: spécifiez le dossier et le sous-dossier dans lesquels vous souhaitez que les fichiers WSDL et XSD soient générés.
      • Nom du fichier WSDL: cochez cette case et entrez le nom du fichier dans lequel vous souhaitez créer le document WSDL.
      • Nom du fichier XSD de demande: décochez cette case.
      • Nom du fichier XSD de réponse: décochez cette case.
      Remarque: Les fichiers XSD ne sont pas requis par l'accès SOAP IMS . Toutefois, en option, vous pouvez sélectionner ces deux cases à cocher pour générer les deux fichiers XSD. Vous pouvez générer des artefacts directement dans le z/OS UNIX System Services système de fichiers (voir Génération d'artefacts à distance ).
    3. Cliquez sur Terminer.
Les fichiers suivants sont générés:
  • Fichier WSDL (.wsdl).
  • Fichier du corrélateur (.xml).
  • Fichier contenant le pilote de service Web et les programmes de conversion XML d'exécution (.cbl).
  • Les fichiers XSD request et response (.xsd).

Après avoir créé les fichiers d'interface de service, l'étape suivante consiste à déployer les fichiers d'interface de service sur le IMS Enterprise Suite SOAP Gateway à l'aide de l'outil de déploiement SOAP d' IMS (voir Déploiement des fichiers de service Web sur l' IMS Enterprise Suite SOAP Gateway ).