COBOL 呼び出しスタブの生成

COBOL 呼び出しスタブ・ジェネレーターを使用して、COBOL プログラムを起動するための Java™ 呼び出しスタブを作成できます。その呼び出しスタブを Java ベースのバッチ・アプリケーションに追加します。

始める前に

『COBOL コンテナーの概要』のトピックをお読みください。

COBOL 呼び出しスタブ・ジェネレーターを使用するのに必要な以下の製品をインストールしてください。

  • IBM® Rational® Application Developer for WebSphere® Software バージョン 7.5 以降 (これにより、J2EE コネクター (J2C) ツールが提供されます)
  • Java ランタイム環境 (JRE) バージョン 1.6.0 以降

Java EE コネクター (J2C) ツールが使用可能であることを検証するには、Rational Application Developer を開始し、Java EE パースペクティブを選択し、「ファイル」 > 「新規」 > 「その他」を選択します。J2C ウィザードが使用可能であれば、J2C プロジェクトを作成でき、J2C ツールが使用可能です。

Rational Application Developer インストール済み環境に Java EE コネクター (J2C) ツールがない場合、Installation Manager を使用して、Rational Application Developer インストール済み環境を変更し、J2C ツールをインストールしてください。

  1. Installation Manager を開始します。
  2. 「パッケージの変更」ページで、「IBM Rational Application Developer for WebSphere Software」 > 「J2EE コネクター (J2C) ツール」 > 「次へ」を選択します。
  3. J2C ツールのインストールを実行します。

このタスクについて

COBOL 呼び出しスタブ・ジェネレーターは、コマンド行から、Ant タスクから、または Rational Application Developer 製品のグラフィカル・インターフェースから実行できます。

COBOL 呼び出しスタブ・ジェネレーターは、以下のステップを実行します。

  1. COBOL ソース・プログラムを構文解析します。
  2. COBOL プログラムを起動する呼び出しスタブの Java コードを生成します。
  3. COBOL プログラムが使用するパラメーター入力および戻り値用のデータ・バインディングの Java コードを生成します。ソース・プログラムは、COBOL コンパイラーによる構文解析とコンパイルが完了している有効な COBOL プログラムであると想定されます。

COBOL パラメーターおよび戻り値用の Java データ・バインディング・クラスは、J2C データ・バインディング・ツールによって生成されます。このツールは、Rational Application Developer 製品の Java EE コネクター・ツール群の一部です。COBOL 呼び出しスタブ・ジェネレーターをコマンド行から実行すると、呼び出しスタブ・ジェネレーターおよびデータ・バインディング・ツールはヘッドレス Eclipse セッションで稼働します。ヘッドレス Eclipse セッションは、独立した Java プロセスとして起動されます。COBOL 呼び出しスタブ・ジェネレーターをグラフィカル・インターフェースから実行すると、呼び出しスタブ・ジェネレーターおよびデータ・バインディング・ツールは、アクティブな Rational Application Developer セッション内で稼働します。

手順

  1. 生成されるコード用の Rational Application Developer プロジェクトを作成します。
  2. COBOL ソース・ファイル内の PROCEDURE ステートメントを確認します。
    PROCEDURE ステートメントは、COBOL ソース・ファイルによって組み込まれるコピーブック内ではなく、そのソース・ファイル内にリストされている必要があります。呼び出しスタブ・ジェネレーターは、COBOL ソース・ファイル内で PROCEDURE ステートメントを検出できない場合、次のエラーで失敗します。
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Unable to find PROCEDURE statement in file COBOL_source_file
    また、PROCEDURE ステートメントでは、重複するパラメーター名が USING 節に含まれていてはなりません。重複するパラメーター名が USING 節に 含まれている場合、呼び出しスタブ・ジェネレーターは次のエラーで失敗します。
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Detected duplicate COBOLDataElement: parameter name
  3. 呼び出しスタブ・ジェネレーター構成ファイルを更新します。

    呼び出しスタブ・ジェネレーター構成ファイルに関するトピックを参照してください。

  4. COBOL 呼び出しスタブ・ジェネレーターを実行します。

    呼び出しスタブ・ジェネレーターは以下の 3 つの方法で実行できます。

    コマンド行から
    1. 呼び出しスタブ・ジェネレーターを起動するスクリプトを作成します。
    2. スクリプトを実行します。
      $ java –jar lib/COBOLCallStubGenerator.jar script_path/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    コマンド行からの呼び出しスタブ・ジェネレーターの起動に関するトピックを参照してください。

    Ant プログラムから
    1. 呼び出しスタブ・ジェネレーターを起動する Ant タスクを定義します。
    2. 呼び出しスタブ・ジェネレーターを実行するための Ant ビルド・ファイル (例えば、COBOL 呼び出しスタブ・ジェネレーター付属の CSG.xml ファイルなど) を指定します。
    3. Ant ビルド・ファイルを実行します。

    Ant タスクからの呼び出しスタブ・ジェネレーターの起動に関するトピックを参照してください。

    Rational Application Developer グラフィカル・インターフェースから
    1. 「実行」 > 「外部ツール」 > 「外部ツール構成」メニューで、呼び出しスタブ・ジェネレーターを起動する Ant ビルドを構成します。
    2. 呼び出しスタブ・ジェネレーターを実行するための Ant ビルド・ファイル (例えば、CSG.xml) を指定します。
    3. Ant ビルド・ファイルを実行します。

    グラフィカル・インターフェースからの呼び出しスタブ・ジェネレーターの 起動に関するトピックを参照してください。

タスクの結果

呼び出しスタブ・ジェネレーター起動が成功すると、呼び出しスタブ・ジェネレーターは、COBOL プログラムを起動する Java 呼び出しスタブを作成します。

ヘッドレス Rational Application Developer 起動では、呼び出しスタブ・ジェネレーター実行時にエラーが発生する場合があります。コマンド行または Ant タスクからの呼び出しスタブ・ジェネレーターの実行は、ヘッドレス起動を使用します。以下のログを調べることで、エラーが発生した場合のトラブルシューティングを行うことができます。
workspace_path/.metadata/.log
このログでは、Eclipse ベースのツールでの問題 (ヘッドレス起動が開始しなかったなど) がエラーの原因かどうかを識別できます。
user_home/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
ヘッドレス起動ごとに、configuration ディレクトリーにログ・ファイルが作成される場合があります。ログ・ファイルが存在する場合、エラーに関するトラブルシューティング情報が含まれている場合があります。

次のタスク

生成された Java 呼び出しスタブを使用して、COBOL プログラムを起動します。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_generate
ファイル名:tgrid_cobol_csg_generate.html