Exécution du générateur de module de remplacement d'appel à partir d'une ligne de commande

Vous pouvez exécuter le générateur de module de remplacement d'appel COBOL à partir d'une ligne de commande.

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 en ligne de commande, vous devez exécuter une commande qui indique des valeurs pour les paramètres configFile et callStubPackage requis. Vous pouvez également indiquer des valeurs pour les paramètres facultatifs de la commande.

La commande qui exécute le générateur de remplacement d'appel COBOL doit utiliser la syntaxe suivante :

java –jar COBOLCallStubGenerator.jar 
    {input cobol file} 
    -configFile configuration_file_name
    -callStubPackage package_name
    [-callStubClass class_name]
    [-cobolModule COBOL_module]
    [-workSpace path_name]
    [-eclipseProjectName project_name]
    [-build build_string]
    [-mockPackage package_name]
    [-mockClass class_name]
    [-v | -verbose]
    [-? | -h]
Tableau 1. Paramètres de commande permettant d'exécuter le générateur de module de remplacement d'appel COBOL. Définitions des paramètres de commande.
Name Valeur par défaut Requis ou facultatif Description
configFile   Obligatoire Indique le nom du fichier de configuration du générateur de module de remplacement d'appel.
callStubPackage   Obligatoire Indique le nom du package et le chemin du fichier généré, à utiliser pour le module de remplacement d'appel créé.
callStubClass COBOL PROGRAM-ID Facultatif Indique le nom de classe à utiliser pour le module de remplacement d'appel généré.
cobolModule COBOL PROGRAM-ID Facultatif Indique le nom du module COBOL ou du fichier DLL qui contient le programme COBOL.
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.

générer 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.

Procédure

  1. Créez un script qui exécute le générateur de module de remplacement d'appel.
  2. Assurez-vous qu'une session Rational Application Developer n'est pas active pour l'espace de travail.
  3. Exécutez le script.

    Par exemple, exécutez la commande suivante pour exécuter le script Sample01.cbl. Le fichier de configuration s'appelle csg.properties et la package de module de remplacement a pour nom my.pkg.

    $ java –jar lib/COBOLCallStubGenerator.jar script_path/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

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 une classe Java de module de remplacement d'appel COBOL.

Lors de l'exécution de la commande, le générateur de module de remplacement d'appel crée un fichier de génération Ant temporaire, répertoire_temp_système/CSG.temp.xml, puis exécute le fichier dans une session Eclipse sans interface graphique. Le fichier temporaire est supprimé après l'exécution de la commande.

Les classes de liaison de données Java pour les paramètres et la valeur de retour COBOL sont générées par l'outil de liaison de données J2C, lequel fait partie des outils Java EE Connector d'IBM® Rational Application Developer for WebSphere Software, version 7.5 ou ultérieure. Le générateur de module de remplacement d'appel et l'outil de liaison de données J2C sont exécutés dans la session Eclipse sans interface graphique, qui est lancée comme un processus Java distinct.

L'appel d'Eclipse sans interface graphique tente d'obtenir un verrou d'espace de travail avant d'exécuter le fichier de génération Ant. Si une session Rational Application Developer est active pour l'espace de travail, Eclipse ne peut pas obtenir de verrou d'espace de travail et la commande échoue.

Que faire ensuite

Utilisez la classe Java de module de remplacement d'appel COBOL générée.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_commandline
Nom du fichier : tgrid_cobol_csg_commandline.html