COBOL-Aufrufstubs generieren

Sie verwenden den COBOL-Aufrufstubgenerator, um einen Java™-Aufrufstub für den Aufruf eines COBOL-Programms zu erstellen. Sie fügen den Aufrufstub einer Java-basierten Stapelanwendung hinzu.

Vorbereitende Schritte

Lesen Sie den Artikel mit der Übersicht über den COBOL-Container.

Installieren Sie die folgenden Produkte, die erforderlich sind, um den COBOL-Aufrufstubgenerator zu verwenden:

  • IBM® Rational Application Developer for WebSphere Software, Version 7.5 oder höher: stellt die J2C-Tools (J2EE Connector) bereit
  • Java Runtime Environment (JRE) Version 1.6.0 oder höher

Um sicherzustellen, dass die J2C-Tools aktiviert sind, starten Sie Rational Application Developer. Wählen Sie die Java EE-Perspektive und anschließend File > New > Other aus. Wenn der J2C-Assistent verfügbar ist, können Sie ein J2C-Projekt erstellen, und die J2C-Tools sind verfügbar.

Wenn die Installation von Rational Application Developer die J2C-Tools nicht enthält, verwenden Sie Installation Manager, um Ihre Installation von Rational Application Developer zu ändern und die J2C-Tools zu installieren:

  1. Starten Sie Installation Manager.
  2. Wählen Sie auf der Seite "Pakete ändern" nacheinander IBM Rational Application Developer for WebSphere Software > J2C-Tools > Weiter aus.
  3. Führen Sie die Installation der J2C-Tools durch.

Informationen zu diesem Vorgang

Sie können den COBOL-Aufrufstubgenerator über eine Befehlszeile, eine Ant-Task oder über die grafische Schnittstelle des Produkts Rational Application Developer ausführen.

Der COBOL-Aufrufstubgenerator führt die folgenden Schritte aus:

  1. Er parst das COBOL-Quellenprogramm.
  2. Er generiert den Java-Code für den Aufrufstub, um das COBOL-Programm aufzurufen.
  3. Er generiert den Java-Code für die Datenbindungen für die Parametereingaben und den Rückgabewert, die vom COBOL-Programm verwendet werden. Es wird angenommen, dass das Quellenprogramm ein gültiges COBOL-Programm ist, das geparst und von einem COBOL-Compiler kompiliert wird.

Die Java-Datenbindungsklassen für die COBOL-Parameter und -Rückgabewerte werden vom J2C-Datenbindungstool generiert, das zu Java EE-Connector-Tools des Produkts Rational Application Developer gehört. Wenn Sie den COBOL-Aufrufstubgenerator über eine Befehlszeile ausführen, werden der Aufrufstubgenerator und das Datenbindungstool in einer Eclipse-Sitzung ohne GUI ausgeführt. Die Eclipse-Sitzung ohne GUI wird als separater Java-Prozess gestartet. Wenn Sie den COBOL-Aufrufstubgenerator über die grafische Schnittstelle ausführen, werden der Aufrufstubgenerator und das Datenbindungstool in der aktiven Sitzung von Rational Application Developer ausgeführt.

Vorgehensweise

  1. Erstellen Sie in Rational Application Developer ein Projekt für den generierten Code.
  2. Überprüfen Sie die Anweisung PROCEDURE in der COBOL-Quellendatei.
    Die Anweisung PROCEDURE muss in der COBOL-Quellendatei und nicht nicht in einem von der Quellendatei eingeschlossenen Copybook aufgelistet sein. Wenn der Aufrufstubgenerator die Anweisung PROCEDURE nicht in der COBOL-Quellendatei findet, schlägt der Aufrufstubgenerator mit einem Fehler fehl:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Unable to find PROCEDURE statement in file COBOL-Quellendatei
    Außerdem darf die Anweisung PROCEDURE keine doppelten Parameternamen in der Klausel USING enthalten. Wenn die Klausel USING einen doppelten Parameternamen enthält, schlägt der Aufrufstubgenerator mit einem Fehler fehl:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Detected duplicate COBOLDataElement: Parametername
  3. Aktualisieren Sie die Konfigurationsdatei des Aufrufstubgenerators.

    Weitere Informationen finden Sie im Artikel zur Konfigurationsdatei des Aufrufstubgenerators.

  4. Führen Sie den COBOL-Aufrufstubgenerator aus.

    Es stehen drei Optionen für die Ausführung des Aufrufstubgenerator bereit:

    Über eine Befehlszeile
    1. Erstellen Sie ein Script, das den Aufrufstubgenerator aufruft.
    2. Führen Sie das Script aus.
      $ java –jar lib/COBOLCallStubGenerator.jar Scriptpfad/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    Weitere Informationen finden Sie im Artikel zum Aufrufen des Aufrufstubgenerators über eine Befehlszeile.

    Über ein ANT-Programm
    1. Definieren Sie eine Ant-Task, die den Aufrufstubgenerator aufruft.
    2. Geben Sie eine Ant-Builddatei an, z. B. die Datei CSG.xml, die mit dem COBOL-Aufrufstubgenerator bereitgestellt wird, um den Aufrufstubgenerator auszuführen.
    3. Führen Sie die Ant-Builddatei aus.

    Weitere Informationen finden Sie im Artikel zum Aufrufen des Aufrufstubgenerators über eine Ant-Task.

    Über die grafische Schnittstelle von Rational Application Developer
    1. Konfigurieren Sie einen Ant-Build im Menü Ausführen > Externe Tools > Konfiguration für externe Tools, das den Aufrufstubgenerator aufruft.
    2. Geben Sie an, dass der Aufrufstubgenerator über eine Ant-Builddatei, wie z. B. CSG.xml, ausgeführt wird.
    3. Führen Sie die Ant-Builddatei aus.

    Weitere Informationen finden Sie im Artikel zum Aufrufen des Aufrufstubgenerators über eine grafische Schnittstelle.

Ergebnisse

Wenn der Aufruf des Aufrufstubgenerators erfolgreich ist, erstellt der Aufrufstubgenerator einen Java-Aufrufstub, um ein COBOL-Programm aufzurufen.

Bei einem Aufruf über Rational Application Developer ohne GUI, kann ein Fehler bei der Ausführung des Aufrufstubgenerators auftreten. Wenn der Aufrufstubgenerator über eine Befehlszeile oder eine Ant-Task ausgeführt wird, wird ein Aufruf ohne GUI verwendet. Untersuchen Sie die folgenden Protokolle, um einen Fehler zu beheben:
Arbeitsbereichspfad/.metadata/.log
Das Protokoll gibt Aufschluss darüber, ob Probleme mit den Eclipse-basierten Tools aufgetreten sind, z. B., dass ein Aufruf ohne GUI nicht erfolgreich war.
Ausgangsverzeichnis_des_Benutzers/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
Bei jedem Aufruf ohne GUI können Protokolldateien im Verzeichnis configuration erstellt werden. Wenn die Protokolldateien vorhanden sind, können sie Informationen zur Behebung des Fehlers enthalten.

Nächste Schritte

Verwenden Sie den generierten Java-Aufrufstub, um ein COBOL-Programm aufzurufen.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_generate
Dateiname:tgrid_cobol_csg_generate.html