COBOL 呼び出しスタブ・ジェネレーターを、Rational® Application Developer グラフィカル・インターフェースから Ant ビルドとして実行できます。
始める前に
COBOL 呼び出しスタブ・ジェネレーターによって生成されるコード用に、Rational Application Developer プロジェクトを作成します。
呼び出しスタブ・ジェネレーター構成ファイルを作成します。必須プロパティー EclipseHome、WorkSpace、および EclipseProjectName の設定値が正しいことを確認します。
COBOL ソース・ファイルの PROCEDURE ステートメントを確認します。
このタスクについて
COBOL 呼び出しスタブ・ジェネレーターを Rational Application Developer グラフィカル・インターフェースから実行するには、使用する <csg> タスク・ファイルを指定し、そのタスク・ファイルをワークスペースと同じ Java™ ランタイム環境 (JRE) で実行します。
<csg> タスク・ファイル用に、サンプル Ant ビルド・ファイル CSG.xml (IBM®
Rational Application Developer for WebSphere® Software 製品の呼び出しスタブ・ジェネレーターと共に提供されます) を使用できます。CSG.xml 入力プロパティーの説明については、
呼び出しスタブ・ジェネレーター CSG.xml ファイルに関するトピックを参照してください。<csg> の属性およびエレメントの説明については、Ant タスクからの呼び出しスタブ・ジェネレーターの起動に関するトピックを参照してください。
<csg> タスクおよびデータ・バインダー Ant ビルド・ファイルは、実行時に、一部の Eclipse クラス (Java EE コネクター (J2C) ツールを含む) に依存します。<csg> タスクを Rational Application Developer 内で Ant ビルドとして実行する場合、すべての前提条件が製品によって取得されます。
手順
- <csg> タスク・ファイルを実行するように Ant ビルドを構成します。
「外部ツール構成」ページで <csg> タスク・ファイルを指定します。
- をクリックします。
- 「メイン」タブの「ビルド・ファイル」に、<csg> タスク・ファイルの絶対パス名を指定します。
例えば、CSG.xml Ant ビルド・ファイルを使用するには、次のように指定します。
product_installation_root/CobolCallStubGenerator.V1.2/CSG.xml
- 「メイン」タブの「引数」に、必須の CSG.xml 入力プロパティーの値を指定します。
例えば、CSG.xml Ant ビルド・ファイルの場合、必須プロパティーに対して以下のような値を指定します。
-DcobolSource=${resource_loc}
-DworkSpace=${workspace_loc}
-DeclipseProjectName=${project_name}
-DcallStubPackage=${string_prompt:callStubPackage}
プロパティーの説明 (resource_loc などの組み込み変数の説明を含む) については、呼び出しスタブ・ジェネレーター CSG.xml ファイルに関するトピックを参照してください。
- 「メイン」タブで、「入力ハンドラーの設定」を選択します。
- 「JRE」タブで、「ワークスペースと同じ JRE で実行」を選択します。
この設定によって、必要な Java EE コネクター (J2C) ツールが JRE に組み込まれます。
- オプション: 「リフレッシュ」タブで、Ant ビルド・ツールが実行前にプロジェクトまたはワークスペースを作成することを指定します。
- オプション: 「ビルド」タブで、Ant ビルド・ツールが実行後にプロジェクトまたはワークスペースをリフレッシュすることを指定します。
- 「適用」をクリックして、構成を保存します。
- オプション: Rational Application Developer ワークスペースのコピーブック組み込みパスを設定します。
Rational 資料で、COBOL インポーター設定についてのトピックを参照してください。
- 呼び出しスタブ・ジェネレーターを実行します。
- 「パッケージ・エクスプローラー」ビューで、COBOL ソース・ファイルを選択します。
例えば、COBOL ソース・ファイルの名前が my_source.cbl である場合、「パッケージ・エクスプローラー」のナビゲーション・ツリーで my_source.cbl を選択します。
- 「実行」メニューから、 を選択して、呼び出しスタブ・ジェネレーターを実行します。
ツールを初めて実行する場合、「外部ツール」メニューに呼び出しスタブ・ジェネレーター Ant ファイルがオプションとして表示されないことがあります。この問題を修正するには、「外部ツール構成」」ページからツールを実行してください。
タスクの結果
呼び出しスタブ・ジェネレーターが実行され、出力が Rational Application Developer コンソールに表示されます。呼び出しスタブ・ジェネレーターは COBOL 呼び出しスタブの Java クラスを作成します。
次のタスク
生成された COBOL 呼び出しスタブの Java クラスを使用します。