Exécution du générateur de module de remplacement d'appel à partir d'une tâche Ant
Vous pouvez exécuter le générateur de module de remplacement d'appel COBOL à partir d'une tâche Ant.
Avant de commencer
Créez un projet Rational Application Developer pour le code qui est généré par le générateur de module de remplacement d'appel COBOL.
Créez un fichier de configuration de générateur de module de remplacement d'appel. Assurez-vous que les paramètres pour les propriétés requises EclipseHome, WorkSpace et EclipseProjectName sont corrects.
Vérifiez l'instruction PROCEDURE pour le fichier source COBOL.
Pourquoi et quand exécuter cette tâche
Pour exécuter le générateur de module de remplacement d'appel COBOL à partir d'une tâche Ant, vous devez créer une tâche <csg> qui spécifie les valeurs des attributs obligatoires qui identifient le fichier de configuration du générateur de module de remplacement d'appel et les fichiers source COBOL qui sont utilisés en tant que source pour le générateur de module de remplacement d'appel. Vous pouvez également indiquer des valeurs pour les paramètres facultatifs de la tâche. Le tableau 1 présente les attributs <csg>, <cobolModule>; et <dataElement> et les éléments imbriqués pris en charge que vous pouvez utiliser dans la tâche <csg>.
<callStubPackage>com.ibm.cobol.$_ProgramId_$</callStubPackage>
Lors de l'exécution, la variable $_ProgramId_$ est remplacée par l'ID COBOL PROGRAM-ID. Si plusieurs fichiers COBOL sont indiqués par le type <fileset> ou <filelist> entré, la valeur $_ProgramId_$ est remplacée par l'ID PROGRAM-ID de chaque fichier COBOL à mesure que le générateur de module de remplacement d'appel effectue une recherche par itération dans la liste de fichiers d'entrée.Name | Valeur par défaut | Requis ou facultatif | Description |
---|---|---|---|
Attributs et éléments imbriqués <csg> | |||
configFile | Obligatoire | Indique le chemin complet vers le fichier de configuration du générateur de module de remplacement d'appel. | |
workSpace | Facultatif | Indique le chemin complet vers le répertoire racine de l'espace de travail Rational Application Developer ou Eclipse à utiliser pour créer la classe de liaison de données Java™. Toute valeur spécifiée pour l'espace de travail remplace la valeur d'espace de travail indiquée dans le fichier de configuration du générateur de module de remplacement d'appel qui est identifié par la valeur configFile. |
|
eclipseProjectName | Facultatif | Indique le nom du projet dans l'espace de travail Rational Application Developer ou Eclipse qui fournit la base pour la classe Java générée. Le projet doit exister avant l'exécution du générateur de module de remplacement d'appel. Toute valeur spécifiée pour eclipseProjectName remplace la valeur eclipseProjectName indiquée dans le fichier de configuration du générateur de module de remplacement d'appel qui est identifié par la valeur configFile. |
|
antBuildFile | ${workSpace}/${eclipseProjectName}/src/GenAllBindings.xml | Facultatif | Indique l'emplacement de sortie du fichier de génération Ant du classeur de données qui est généré par la tâche <csg>. |
<fileset>, <filelist> | Obligatoire | Indique un ou plusieurs des fichiers source COBOL qui fournissent une entrée sur le générateur de module de remplacement d'appel. Vous pouvez spécifier plusieurs types <fileset> et <filelist>. Les types <fileset> et <filelist> qui sont spécifiés en dehors d'un élément <cobolModule> utilisent l'ID COBOL PROGRAM-ID comme nom de module COBOL. | |
<cobolModule> | Facultatif | Indique le nom du module COBOL ou du fichier de bibliothèque de liaison dynamique qui est associé à tous les fichiers <fileset> et <filelist> qui sont imbriqués dans l'élément <cobolModule>. Vous pouvez spécifier plusieurs éléments <cobolModule>. | |
<callStubPackage> | Obligatoire | Indique le nom du package et le chemin du fichier généré à utiliser pour le module de remplacement d'appel généré. Pour cet élément, vous pouvez indiquer une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_ProgramId_$, l'ID COBOL PROGRAM-ID ou le module COBOL $_CobolModule_$. Par exemple : <callStubPackage>com.ibm.cobol.$_ProgramId_$</callStubPackage> Lors de l'exécution, la variable $_ProgramId_$ est remplacée par l'ID COBOL PROGRAM-ID. |
|
<callStubClass> | COBOL program PROGRAM-ID | Facultatif | Indique le nom de classe à utiliser pour le module de remplacement d'appel généré. Pour cet élément, vous pouvez indiquer une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_ProgramId_$, l'ID COBOL PROGRAM-ID ou le module COBOL $_CobolModule_$. |
<build> | Unknown Build | Facultatif | Indique un identificateur de génération attribué par l'utilisateur. |
<mockPackage> | Facultatif | Indique le nom du package de la classe mock. | |
<mockClass> | Facultatif | Indique le nom de la classe à utiliser pour la routine de test mock. | |
<dataElementsPackage> | {callStubPackage}.parameters | Facultatif | Indique le nom du package à utiliser pour les classes de liaison de données d'un ou de plusieurs paramètres COBOL et la valeur de retour. Pour cet élément, vous pouvez indiquer une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_DataElementName_$ (nom de paramètre COBOL), $_ProgramId_$ (ID COBOL PROGRAM-ID) ou $_CobolModule_$ (module COBOL). |
<dataElementsClass> | Nom de paramètre | Facultatif | Indique le nom de classe à utiliser pour les classes de liaison de données d'un ou de plusieurs paramètres COBOL et la valeur de retour. Pour cet élément, vous pouvez indiquer une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_DataElementName_$ (nom de paramètre COBOL), $_ProgramId_$ (ID COBOL PROGRAM-ID) ou $_CobolModule_$ (module COBOL). Par exemple, pour ajouter l'ID PROGRAM-ID au début des noms de classe pour les paramètres COBOL et la valeur de retour : <dataElementsClass>$_ProgramId_$_$_DataElementName_$</dataElementsClass> Lors de l'exécution, la variable $_ProgramId_$ est remplacée par l'ID COBOL PROGRAM-ID et la variable $_DataElementName_$ est remplacée par le nom du paramètre COBOL ou la valeur de retour. Si le programme COBOL comporte plusieurs paramètres, la variable $_DataElementName_$ est remplacée par le nom de chaque paramètre COBOL à mesure que le générateur de module de remplacement d'appel les parcourt. |
<dataElement> | Facultatif | Indique un nom de package et de classe pour un paramètre COBOL ou une valeur de retour. Le paramètre est identifié à l'aide des attributs name et programId. Les noms de package et de classe sont spécifiés à l'aide des attributs packageName et className. Vous pouvez spécifier plusieurs éléments <dataElement>. | |
Attributs et élément imbriqué <cobolModule> | |||
libname | COBOL program PROGRAM-ID | Facultatif | Indique le nom du module ou du fichier de bibliothèque de liaison dynamique COBOL qui contient un ou plusieurs programmes COBOL. |
<fileset>, <filelist> | Obligatoire | Indique un ou plusieurs des fichiers source COBOL qui fournissent une entrée sur le générateur de module de remplacement d'appel. Chaque fichier COBOL est associé au module COBOL qui est défini par libname. | |
Attributs <dataElement> | |||
name | Obligatoire | Indique le nom du paramètre COBOL PROCEDURE. | |
programId | Obligatoire | Indique l'ID PROGRAM-ID du programme COBOL qui contient le paramètre. | |
packageName | ${callStubPackage}.parameters | Facultatif | Indique le nom du package à utiliser pour la classe de liaison de données pour ce paramètre COBOL ou cette valeur de retour. Pour cet attribut, vous pouvez spécifier une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_DataElementName_$ (nom du paramètre COBOL), $_ProgramId_$ (ID COBOL PROGRAM-ID) ou $_CobolModule_$ (module COBOL). |
className | Nom de paramètre | Facultatif | Indique le nom de classe à utiliser pour la classe de liaison de données pour ce paramètre COBOL ou cette valeur de retour. Pour cet attribut, vous pouvez spécifier une propriété de générateur de module de remplacement d'appel interne pour les variables de substitution $_DataElementName_$ (nom du paramètre COBOL), $_ProgramId_$ (ID COBOL PROGRAM-ID) ou $_CobolModule_$ (module COBOL). |
Procédure
Résultats
La commande exécute le générateur de module de remplacement d'appel. Si la commande aboutit, le générateur de module de remplacement d'appel crée un module de remplacement d'appel Java pour exécuter un programme COBOL.
Que faire ensuite
Utilisez le module de remplacement d'appel Java généré pour exécuter un programme COBOL.