Sie können den COBOL-Aufrufstubgenerator als Ant-Build
über die grafische Schnittstelle von Rational Application Developer aufrufen.
Vorbereitende Schritte
Erstellen Sie ein Projekt in Rational Application Developer für den Code, der vom
COBOL-Aufrufstubgenerator generiert wird.
Erstellen Sie eine Konfigurationsdatei für den
Aufrufstubgenerator. Stellen Sie sicher, dass die Einstellungen für die erforderlichen Eigenschaften
"EclipseHome", "WorkSpace" und "EclipseProjectName" korrekt sind.
Überprüfen Sie die Anweisung PROCEDURE für die COBOL-Quellendatei.
Informationen zu diesem Vorgang
Wenn Sie den COBOL-Aufrufstubgenerator über die grafische Schnittstelle von Rational Application Developer
aufrufen möchten, geben Sie die auszuführende
<csg>-Taskdatei an, und führen Sie die Taskdatei in derselben
Java™ Runtime Environment
(JRE) wie den Arbeitsbereich aus.
Für die <csg>-Taskdatei können Sie die
Ant-Beispielbuilddatei CSG.xml verwenden, die mit dem Aufrufstubgenerator
des Produkts IBM®
Rational Application Developer for WebSphere Software bereitgestellt wird.
Beschreibungen der Eingabeeigenschaften in der Datei CSG.xml finden Sie im Artikel zur Datei
CSG.xml für den Aufrufstubgenerator.
Beschreibungen der <csg>-Attribute und -Elemente finden Sie im Artikel zum Aufrufen des
Aufrufstubgenerators über eine Ant-Task.
Die <csg>-Task und Ant-Builddatei für den Datenbinder
weisen Laufzeitabhängigkeiten von einigen Eclipse-Klassen auf, einschließlich der J2C-Tools (Java EE Connector).
Wenn Sie die <csg>-Task in Rational Application Developer als Ant-Build ausführen,
ruft das Produkt alle Voraussetzungen ab.
Vorgehensweise
- Ant-Builds für die Ausführung der <csg>-Taskdatei konfigurieren.
Geben Sie die <csg>-Taskdatei auf der Seite External Tools Configuration an.
- Klicken Sie auf .
- Geben Sie im Feld Buildfile auf der Registerkarte Main
den vollständigen Pfadnamen für die <csg>-Taskdatei an.
Wenn Sie beispielsweise die Ant-Builddatei CSG.xml verwenden möchten, geben Sie Folgendes an:
Stammverzeichnis_der_Produktinstallation/CobolCallStubGenerator.V1.2/CSG.xml
- Geben Sie im Feld Arguments auf der Registerkarte Main
Werte für die erforderlichen Eingabeeigenschaften in der Datei CSG.xml an.
Geben Sie beispielsweise für die Ant-Builddatei CSG.xml
Werte wie die folgenden für die erforderlichen Eigenschaften an:
-DcobolSource=${resource_loc}
-DworkSpace=${workspace_loc}
-DeclipseProjectName=${project_name}
-DcallStubPackage=${string_prompt:callStubPackage}
Eigenschaftsbeschreibungen, einschließlich Beschreibungen der integrierten Variablen wie resource_loc,
finden Sie im Artikel zur Datei
CSG.xml für den Aufrufstubgenerator.
- Wählen Sie auf der Registerkarte Main den Eintrag Set an Input handler aus.
- Wählen Sie auf der Registerkarte JRE den Eintrag Run
in the same JRE as the workspace aus.
Diese Einstellung stellt sicher, dass die JRE die erforderlichen J2C-Tools (Java EE Connector) enthält.
- Optional: Geben Sie auf der Registerkarte Refresh
an, dass das Projekt bzw. der Arbeitsbereich vor der Ausführung des Tools vom
Ant-Build-Tool erstellt wird.
- Optional: Geben Sie auf der Registerkarte Build
an, dass das Ant-Build-Tool das Projekt bzw. den Arbeitbereich nach der Ausführung des Tools aktualisieren soll.
- Klicken Sie auf Apply, um die Konfiguration zu speichern.
- Optional: Copybook, einschließlich Pfad, für den Arbeitsbereich von Rational Application Developer konfigurieren.
Informationen hierzu finden Sie im Artikel zum Festlegen der Benutzervorgaben für das COBOL-Importprogramm
in der Rational-Dokumentation.
- Führen Sie den Aufrufstubgenerator aus.
- Wählen Sie in der Paketexploreransicht eine COBOL-Quellendatei aus.
Wenn Ihre COBOL-Quellendatei beispielsweise den Namen my_source.cbl hat, wählen Sie
my_source.cbl in der Navigationsstruktur des Paketexplorers aus.
- Wählen Sie im Menü Run die Option aus, um den
Aufrufstubgenerator auszuführen.
Wenn Sie das Tool zum ersten Mal ausführen, wird die Ant-Datei des Aufrufstubgenerators
möglicherweise nicht als Option im Menü External Tools angezeigt.
Sie können dieses Problem beheben, indem Sie das Tool über die Seite
External Tools Configuration ausführen.
Ergebnisse
Der Aufrufstubgenerator wird ausgeführt, und die Ausgabe wird in der Konsole von
Rational Application Developer ausgegeben.
Der Aufrufstubgenerator erstellt eine Java-Klasse für COBOL-Aufrufstubs.
Nächste Schritte
Verwenden Sie die generierte Java-Klasse für COBOL-Aufrufstubs.