Construction de beans Java J2C à l'aide de l'importateur par lots

Vous pouvez créer des classes de liaison J2C et y accéder par le biais de l'importateur par lots et de son interface de ligne de commande, plutôt que d'utiliser l'assistant de liaison de données J2C. Vous pouvez également exécuter l'importateur par lots à partir du plan de travail.

Avant de commencer

L'importateur par lots vous permet de créer des classes de liaison J2C pour les adaptateurs de ressources de l'interface ECI CICS et IMS. Vous pouvez créer des classes de liaison J2C et y accéder par le biais de l'importateur par lots et de son interface de ligne de commande, plutôt que d'utiliser l'assistant de liaison de données J2C. Vous pouvez également exécuter l'importateur par lots à partir du plan de travail.

Pourquoi et quand exécuter cette tâche

Vous devez modifier les paramètres de cinq fichiers pour les adapter à votre environnement. Ces fichiers se trouvent dans <rép_install>/IBM/SDPShared/plugins/com.ibm.adapter.j2c.command/runtime et dans <rép_install>/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/sample.
  1. CICSECI_PlatformProperties.xml : définit les paramètres du fichier source C ou COBOL qui est appelé par défaut, selon la plateforme utilisée pour exécuter l'importateur par lots (NT, AIX ou MVS).
  2. CICSECI_cobolSample.xml : contient les propriétés de service qui seront utilisées par l'importateur par lots :
    • EISProject
      • name : nom du projet de service qui contiendra le nouveau service d'entreprise. Si ce projet de service n'existe pas, il sera créé automatiquement.
        Remarque : Le fichier exemple contient un élément ImportPropertyArray dans la propriété EISProject. Les propriétés d'importation contenues ici remplaceront les valeurs définies dans le fichier PlatformProperties.xml. Si les valeurs par défaut de ce dernier sont correctes pour ce service, vous pouvez alors supprimer l'élément ImportPropertyArray.
    • EISService : une ou plusieurs entrées pour chaque EISProject
      • name : nom du service d'entreprise. Après l'importation des fichiers C ou COBOL, trois fichiers WSDL sont créés pour chacun des services (un fichier d'interface, un fichier de liaison et un fichier de service).
      • type : adaptateur de ressources utilisé pour le service. Il s'agit du nom du projet de connecteur qui contient le fichier RAR.
      • targetNameSpace : URL de l'espace de nom cible (http://...). Un package dont le nom tient compte de la propriété targetNameSpace est créé dans le projet de service pour contenir les fichiers WSDL générés.
      • generateHelpers : si les données natives que vous importez sont constituées de types complexes tels que des structures C, des classes auxiliaires sont alors requises lors de l'exécution du service. Si la valeur de cette option est "true", le programme d'importation par lots crée et compile automatiquement ces classes pour vous.
    • Operation : une ou plusieurs entrées pour chaque EISService :
      • name : nom de l'opération.
      • type : type d'opération : soit REQUEST_RESPONSE, qui contient une définition InputMessage et une définition OutputMessage, soit ONE_WAY, qui contient une définition InputMessage.
        Remarque : Si ces deux dernières définitions sont du même type, une seule définition regroupant message d'entrée et de sortie est utilisée.
    • Message
      • importFile : fichier contenant la définition à utiliser pour la création de l'opération du service d'entreprise.
      • importDirectory : chemin contenant le fichier d'importation. Si aucun attribut importDirectory n'est spécifié, le répertoire d'entrée (rép_entrée) et le répertoire courant sont utilisés pour rechercher le fichier d'importation.
      • nativeTypeName : type de données à importer du fichier désigné par importFile. En COBOL, par exemple, il s'agit probablement de DFHCOMMAREA. Si aucun nom de type natif n'est identifié comme type de données valide par l'analyse syntaxique du fichier d'importation (importFile), une erreur est renvoyée.
      • name : nom à utiliser pour le type qui est importé. Par exemple, si DFHCOMMAREA représentait des données relatives aux clients de l'entreprise, vous pourriez utiliser le nom Client.
      • generationPackage (optionnel) : attribut qui vous permet de définir un nom de package différent pour les classes auxiliaires générées (les beans et les gestionnaires de format). Vous obtenez ainsi un espace de nom différent pour le schéma généré dans le fichier WSDL d'interface.
  3. sampleContainer.xml : ce fichier est passé comme argument à l'importateur par lots. Il contient la liste des fichiers (ImportDefinitions) devant être traités. L'élément ImportDefinitionArray a les attributs suivants :
    • platform : plateforme du système hôte. Elle peut avoir les valeurs suivantes : NT, AIX ou OS390.
    • platformProperties : fichier de propriétés de la plateforme.
  4. importBatch.bat (Windows) ou importBatch.sh (Linux) : fichier programme de l'importateur par lots, avec les paramètres suivants :
    • containerFile : fichier défini à l'étape 3.
    • Paramètres facultatifs
      • generationStyle
        • 0 (valeur par défaut) : reprend le style de génération propre à WebSphere Studio V5.0.
        • 1 : correspond aux options de génération VisualAge® for Java™ : directe, sans notification, sans classe interne, sans abréviation de noms, avec des tableaux de type primitif.
        • 2 : correspond aux options de génération VisualAge for Java™ : directe, sans notification, sans classe interne, avec abréviation de noms, avec des tableaux de type primitif.
      • workspace : chemin qualifié complet de l'espace de travail à utiliser pour l'importation.
      • RAD_installdir : répertoire dans lequel Rational Application Developer est installé.
  5. Fichier source C ou COBOL : vous utiliserez ce fichier COBOL (TADERC99.ccp) ou C pour créer les fichiers de liaison de données et les fichiers d'interface via l'importateur par lots.

Procédure

  1. Exécution de l'importateur par lots à partir de la ligne de commande : suivez cette procédure pour appeler l'importateur par lots à partir de la ligne de commande :
    1. Assurez-vous d'avoir bien importé dans votre espace de travail l'adaptateur de ressources que vous souhaitez utiliser.
    2. Créez un répertoire destiné à accueillir les fichiers mentionnés au début. Ce répertoire sera appelé rép_entrée dans les étapes restantes.
    3. Définissez la langue et les propriétés de connexion pour votre système hôte dans le fichier de propriétés d'une plateforme. Copiez le fichier de propriétés approprié à la plateforme (CICSECI_PlatformProperties.xml ou IMS_PlatformProperties.xml) depuis le répertoire <rép_install>/plugins/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/sample vers le répertoire rép_entrée, puis ouvrez ce fichier dans un éditeur de texte. Définissez ensuite dans ce fichier les propriétés par défaut de votre environnement cible. Toute propriété définie dans ce fichier peut être remplacée dans le fichier de définitions de service décrit à l'étape suivante. Il n'est pas nécessaire de supprimer les définitions de plateformes non utilisées.
    4. Copiez le fichier exemple de définition de service approprié (CICSECI_cSample.xml, CICSECI_cobolSample.xml ou IMS_cobolSample.xml) dans rép_entrée en le renommant comme vous le souhaitez.
    5. Copiez le fichier conteneur exemple, sampleContainer.xml, dans rép_entrée en le renommant comme vous le souhaitez. Ouvrez-le avec un éditeur de texte, définissez la plateforme appropriée et, pour chaque définition de service créée à l'étape d, ajoutez un élément ImportDefinition renvoyant au fichier de définitions de service que vous avez créé.
    6. Si une instance de Rational Application Developer utilisant l'espace de travail est en cours de fonctionnement, fermez-là.
    7. A partir de la ligne de commande, appelez la commande importBatch avec les options suivantes : importBatch -file=containerFile [-style=generationStyle] [-d workspace] [-e RAD_installdir]
      Remarque : Le paramètre -file doit avoir un chemin complet du système de fichiers pour le fichier containerFile.
  2. Exécution de l'importateur par lots à partir du plan de travail : suivez cette procédure pour appeler l'importateur par lots à partir du plan de travail :
    1. Assurez-vous d'avoir bien importé dans votre espace de travail l'adaptateur de ressources que vous souhaitez utiliser.
    2. Créez un projet simple (nommez-le Temp) destiné à accueillir les fichiers mentionnés au début. Ce répertoire sera appelé rép_entrée dans les étapes restantes.
    3. Effectuez l'étape c, l'étape d et l'étape e de la procédure Exécution de l'importateur par lots à partir de la ligne de commande.
    4. Copiez le fichier batchImport.xml depuis le répertoire <rép_install>/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/script vers le répertoire rép_entrée. Renommez sampleContainer.xml pour qu'il corresponde au nom de votre fichier conteneur.
    5. Faites un clic droit sur batchImport.xml et sélectionnez Exécuter > Génération Ant. Dans la fenêtre qui s'ouvre, sélectionnez JRE > Exécuter dans le même JRE que l'espace de travail. Cliquez sur Appliquer puis sur Fermer. Vous n'aurez à effectuer cette étape qu'une seule fois.
    6. Faites un clic droit sur batchImport.xml et sélectionnez Exécuter > Génération Ant.

      L'importateur par lots importe les fichiers COBOL et C et génère les fichiers de liaison de données dans le projet (EISProject) et le package (tiré de targetNameSpace) définis dans le fichier XML.

      Remarque : L'importateur par lots appelé à partir de la ligne de commande suit le même processus d'exécution que lorsqu'il est exécuté à partir de l'espace de travail. Pour vous en convaincre, ouvrez l'espace de travail dans lequel les fichiers mentionnés au début ont été générés. Vous devez voir un projet nommé Temp, contenant les mêmes fichiers que ceux importés manuellement à l'étape 1.

Commentaires