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.
- 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).
- 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 :
- 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.
- 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.
- 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é.
- 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
- 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 :
- Assurez-vous d'avoir bien importé dans votre espace de travail l'adaptateur de ressources que vous
souhaitez utiliser.
- 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.
- 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.
- 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.
- 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éé.
- Si une instance de
Rational
Application Developer utilisant l'espace de travail est en cours de
fonctionnement, fermez-là.
- 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.
- 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 :
- Assurez-vous d'avoir bien importé dans votre espace de travail
l'adaptateur de ressources que vous souhaitez utiliser.
- 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.
- 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.
- 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.
- Faites un clic droit sur batchImport.xml et sélectionnez . Dans la fenêtre qui s'ouvre, sélectionnez . Cliquez
sur Appliquer puis sur Fermer. Vous n'aurez à effectuer cette étape qu'une seule fois.
- Faites un clic droit sur batchImport.xml et sélectionnez .
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.