CICS® Java アプリケーションを、OSGi 仕様に準拠する Eclipse プラグイン・プロジェクトとして作成します。OSGi サービス・プラットフォームは、コンポーネント・モデルを使ってアプリケーションを開発し、それらのアプリケーションを OSGi バンドルとしてフレームワークに配置するためのメカニズムを提供します。
プラグイン・プロジェクトは OSGi バンドルであり、CICS リソースにアクセスして他の言語で記述されたプログラムと対話する JCICS クラス・ライブラリーを含む、CICS Java アプリケーションで必要とされるすべてのファイルと成果物が含まれます。
完成したアプリケーションは、CICS バンドル・プロジェクトに追加されてから、ホスト・システムにエクスポートされます。
このタスクについて
このタスクでは、新しいプラグイン・プロジェクトを作成します。
特に記載されている場合を除き、設定はデフォルト値のままにしておくことができます。
プロジェクトを作成する場合、マニフェストを編集して、JCICS API の依存関係を追加する必要があります。
手順
- Eclipse メニュー・バーで、「ファイル」>「新規」>「プロジェクト (Project)」をクリックして、「新規プロジェクト」ウィザードを開きます。
- 表示されるリストから、「プラグイン・プロジェクト (Plug-in Project)」を選択し、「次へ」をクリックして「新規プラグイン・プロジェクト (New Plug-in Project)」ウィザードを開きます。
- 「プロジェクト名」フィールドに、プロジェクトの名前を入力し、「ターゲット・プラットフォーム」セクションで、「OSGi フレームワーク (an OSGi framework)」を選択して、メニューから「標準」を選択します。「次へ」をクリックします。 「コンテンツ (Content)」ペインが表示されます。
- 「バージョン」フィールドで、バージョン番号の最後から ".qualifier" を削除します。修飾子は現在サポートされていません。
- 「実行環境 (Execution Environment)」フィールドで、CICS ランタイム・ターゲット・プラットフォームの実行環境に一致する Java のレベルを選択します。
- 「アクティベーターを生成 (Generate an activator)」チェック・ボックスをクリアして、「終了」をクリックします。 「パッケージ・エクスプローラー (Package Explorer)」ビューで、新しいプラグイン・プロジェクトが作成されます。
- 必須: 要件: ここでプラグイン・マニフェスト・ファイルを編集して、JCICS API の依存関係を追加する必要があります。
これらのステップを実行しない場合、バンドルをエクスポートしてインストールできますが、動作しません。
- 「パッケージ・エクスプローラー (Package Explorer)」ビューで、プロジェクト名を右クリックして、「PDE ツール (PDE Tools)」>「マニフェストを開く (Open Manifest)」をクリックします。 マニフェスト・ファイルがマニフェスト・エディターで開きます。
- 「依存関係 (Dependencies)」タブを選択して、「インポートされたパッケージ (Imported Packages)」セクションで、「追加」をクリックします。 「パッケージの選択 (Package Selection)」ダイアログが開きます。
- パッケージ com.ibm.cics.server を選択して、「OK」をクリックします。 パッケージが「インポートされたパッケージ (Imported Packages)」リストに表示されます。
- オプション: オプション: アプリケーションで必要な場合には、次のパッケージをインストールするために上記のステップを繰り返します。
表 1. パッケージ |
説明 |
com.ibm.record |
VisualAge に付属の Java レコード・フレームワークから IByteBuffer を使用するレガシー・プログラム用の Java API。
以前は dfjcics.jar ファイル内にありました。 |
com.ibm.cics.samples |
System.out および System.err をリダイレクトするためのサンプル。dfjoutput.jar ファイルを置き換えます。 |
- Ctrl +S を押して、マニフェスト・ファイルを保存します。
タスクの結果
JCICS API の依存関係を含む新しいプラグイン・プロジェクトが作成されました。
次のタスク
これで、CICS Java アプリケーションを作成できます。
CICS 用の Java アプリケーションの開発が初めての場合は、CICS Explorer® SDK とともに提供される JCICS のサンプルを使用して開始することができます。
注: アプリケーションを開発したら、CICS-MainClass 宣言をマニフェスト・ファイルに追加して、アプリケーションで使用されるクラスを宣言する必要があります。
詳しくは、関連リンクを参照してください。
プラグインの開発について詳しくは、Eclipse のヘルプ資料の「Platform plug-in developer
guide」を参照してください。
Java アプリケーションが終了したら、CICS バンドル内のそのアプリケーションを zFS に配置する必要があります。CICS バンドルは、1 つ以上のプラグインを含むことができ、CICS のアプリケーションの配置の単位です。