Génération de modules de remplacement d'appel COBOL

Vous pouvez utiliser le générateur de module de remplacement d'appel COBOL pour créer un module de remplacement d'appel Java™ pour appeler un programme COBOL. Vous ajoutez le module de remplacement d'appel à une application par lots basée sur Java.

Avant de commencer

Consultez la rubrique de présentation du conteneur COBOL.

Installez les produits suivants, qui sont requis pour l'utilisation du générateur de module de remplacement d'appel COBOL :

  • IBM® Rational Application Developer for WebSphere Software, version 7.5 ou ultérieure, qui fournit les outils J2C (J2EE Connector).
  • Java Runtime Environment (JRE), version 1.6.0 ou ultérieure.

Pour vérifier que les outils J2C (Java EE Connector) sont activés, démarrez Rational Application Developer, sélectionnez la perspective Java EE, puis sélectionnez Fichier > Nouveau > Autre. Si l'assistant J2C est disponible, vous pouvez créer un projet J2C, et les outils J2C sont activés.

Si l'installation Rational Application Developer n'est pas dotée des outils J2C (Java EE Connector), utilisez Installation Manager pour modifier votre installation Rational Application Developer et installez les outils J2C :

  1. Démarrez Installation Manager.
  2. Sur la page de modification des packages, sélectionnez IBM Rational Application Developer for WebSphere Software > Outils J2C (J2EE Connector) > Suivant.
  3. Terminez l'installation des outils J2C.

Pourquoi et quand exécuter cette tâche

Vous pouvez exécuter le générateur de module de remplacement d'appel COBOL depuis une ligne de commande, une tâche Ant ou l'interface graphique du produit Rational Application Developer.

Le générateur de module de remplacement d'appel COBOL effectue les étapes suivantes :

  1. Analyse le programme source COBOL.
  2. Génère le code Java pour le module de remplacement d'appel Java pour appeler le programme COBOL.
  3. Génère le code Java pour les liaisons de données pour les entrées de paramètre et la valeur de retour utilisés par le programme COBOL. Le programme source est considéré comme étant un programme COBOL valide ayant été analysé et compilé par un compilateur COBOL.

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 du produit Rational Application Developer. Lorsque vous exécutez le générateur de module de remplacement d'appel COBOL depuis une ligne de commande, le générateur de module de remplacement d'appel et l'outil de liaison de données s'exécutent dans une session Eclipse sans interface graphique. La session Eclipse sans interface graphique est lancée comme un processus Java distinct. Lorsque vous exécutez le générateur de module de remplacement d'appel COBOL depuis l'interface graphique, le générateur de module de remplacement d'appel et l'outil de liaison de données s'exécutent dans la session Rational Application Developer active.

Procédure

  1. Créez un projet Rational Application Developer pour le code généré.
  2. Vérifiez l'instruction PROCEDURE dans le fichier source COBOL.
    L'instruction PROCEDURE doit être répertoriée dans le fichier source COBOL, et non dans un fichier de stockage inclus par le fichier source. Si le générateur de module de remplacement d'appel ne trouve pas l'instruction PROCEDURE dans le fichier source COBOL, le générateur de module de remplacement d'appel échoue avec l'erreur suivante :
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Unable to find PROCEDURE statement in file COBOL_source_file
    En outre, l'instruction PROCEDURE ne doit pas contenir de noms de paramètre en double dans la clause USING. Si la clause USING contient un nom de paramètre en double, le générateur de module de remplacement d'appel échoue avec l'erreur suivante :
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Detected duplicate COBOLDataElement: parameter name
  3. Mettez à jour le fichier de configuration de générateur de module de remplacement d'appel.

    Consultez la rubrique sur le fichier de configuration de générateur de module de remplacement d'appel.

  4. Exécutez le générateur de module de remplacement d'appel COBOL.

    Vous pouvez exécuter le générateur de module de remplacement d'appel de trois manières :

    A partir d'une ligne de commande
    1. Créez un script qui appelle le générateur de module de remplacement d'appel.
    2. Exécutez le script.
      $ java –jar lib/COBOLCallStubGenerator.jar chemin_script/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    Consultez la rubrique relative à l'appel du générateur de module de remplacement d'appel depuis une ligne de commande.

    A partir d'un programme Ant
    1. Définissez une tâche Ant qui appelle le générateur de module de remplacement d'appel.
    2. Spécifiez un fichier de génération Ant, tel que le fichier CSG.xml qui est fourni avec le générateur de module de remplacement COBOL, pour exécuter le générateur de module de remplacement d'appel.
    3. Exécutez le fichier de génération Ant.

    Consultez la rubrique relative à l'appel du générateur de module de remplacement d'appel depuis une tâche Ant.

    A partir de l'interface graphique de Rational Application Developer
    1. Configurez une génération Ant à partir du menu Run > External Tools > External Tools Configuration qui appelle le générateur de module de remplacement d'appel.
    2. Spécifiez que le fichier de génération Ant, tel que CSG.xml, exécute le générateur de module de remplacement d'appel.
    3. Exécutez le fichier de génération Ant.

    Consultez la rubrique relative à l'appel du générateur de module de remplacement d'appel depuis une interface graphique.

Résultats

Si l'appel du générateur de module de remplacement d'appel aboutit, celui-ci crée un module de remplacement d'appel Java pour appeler un programme COBOL.

Lorsqu'une session Rational Application Developer sans interface graphique est appelée, une erreur peut se produire lors de l'exécution du générateur de module de remplacement d'appel. Lorsque le générateur de module de remplacement d'appel est exécuté à partir d'une ligne de commande ou d'une tâche Ant, un appel sans interface graphique est utilisé. Examinez les journaux suivants pour identifier et résoudre une erreur :
chemin_espacetravail/.metadata/.log
Le journal indique si l'erreur est due à des problèmes liés aux outils Eclipse, tels que l'échec du démarrage de l'appel sans interface graphique.
base_utilisateur/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
Chaque appel sans interface graphique peut créer des fichiers journaux dans le répertoire configuration. Si des fichiers journaux existent, ils peuvent fournir des informations d'identification et de résolution concernant l'erreur.

Que faire ensuite

Utilisez le module de remplacement d'appel Java généré pour appeler un programme COBOL.


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_generate
Nom du fichier : tgrid_cobol_csg_generate.html