プラグイン・プロジェクトの作成

CICS® Java アプリケーションを、OSGi 仕様に準拠する Eclipse プラグイン・プロジェクトとして作成します。OSGi サービス・プラットフォームは、コンポーネント・モデルを使ってアプリケーションを開発し、それらのアプリケーションを OSGi バンドルとしてフレームワークに配置するためのメカニズムを提供します。 プラグイン・プロジェクトは OSGi バンドルであり、CICS リソースにアクセスして他の言語で記述されたプログラムと対話する JCICS クラス・ライブラリーを含む、CICS Java アプリケーションで必要とされるすべてのファイルと成果物が含まれます。 完成したアプリケーションは、CICS バンドル・プロジェクトに追加されてから、ホスト・システムにエクスポートされます。

このタスクについて

このタスクでは、新しいプラグイン・プロジェクトを作成します。 特に記載されている場合を除き、設定はデフォルト値のままにしておくことができます。 プロジェクトを作成する場合、マニフェストを編集して、JCICS API の依存関係を追加する必要があります。

手順

  1. Eclipse メニュー・バーで、「ファイル」>「新規」>「プロジェクト (Project)」をクリックして、「新規プロジェクト」ウィザードを開きます。
  2. 表示されるリストから、「プラグイン・プロジェクト (Plug-in Project)」を選択し、「次へ」をクリックして「新規プラグイン・プロジェクト (New Plug-in Project)」ウィザードを開きます。
  3. 「プロジェクト名」フィールドに、プロジェクトの名前を入力し、「ターゲット・プラットフォーム」セクションで、「OSGi フレームワーク (an OSGi framework)」を選択して、メニューから「標準」を選択します。
    「新規プラグイン (New Plug-in)」ウィザードの画面取り
    「次へ」をクリックします。
    「コンテンツ (Content)」ペインが表示されます。
  4. 「バージョン」フィールドで、バージョン番号の最後から ".qualifier" を削除します。修飾子は現在サポートされていません。
  5. 「実行環境 (Execution Environment)」フィールドで、CICS ランタイム・ターゲット・プラットフォームの実行環境に一致する Java のレベルを選択します。
    メニューが選択され、選択できるオプションのリストを表示した「実行環境 (Execution Environment)」フィールドの画面取り。
  6. 「アクティベーターを生成 (Generate an activator)」チェック・ボックスをクリアして、「終了」をクリックします。 「パッケージ・エクスプローラー (Package Explorer)」ビューで、新しいプラグイン・プロジェクトが作成されます。
  7. 必須: 要件: ここでプラグイン・マニフェスト・ファイルを編集して、JCICS API の依存関係を追加する必要があります。 これらのステップを実行しない場合、バンドルをエクスポートしてインストールできますが、動作しません。
    1. 「パッケージ・エクスプローラー (Package Explorer)」ビューで、プロジェクト名を右クリックして、「PDE ツール (PDE Tools)」>「マニフェストを開く (Open Manifest)」をクリックします。 マニフェスト・ファイルがマニフェスト・エディターで開きます。
    2. 「依存関係 (Dependencies)」タブを選択して、「インポートされたパッケージ (Imported Packages)」セクションで、「追加」をクリックします。 「パッケージの選択 (Package Selection)」ダイアログが開きます。
    3. パッケージ com.ibm.cics.server を選択して、「OK」をクリックします。 パッケージが「インポートされたパッケージ (Imported Packages)」リストに表示されます。
    4. オプション: オプション: アプリケーションで必要な場合には、次のパッケージをインストールするために上記のステップを繰り返します。
      表 1.
      パッケージ 説明
      com.ibm.record VisualAge に付属の Java レコード・フレームワークから IByteBuffer を使用するレガシー・プログラム用の Java API。 以前は dfjcics.jar ファイル内にありました。
      com.ibm.cics.samples System.out および System.err をリダイレクトするためのサンプル。dfjoutput.jar ファイルを置き換えます。
    5. 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 のアプリケーションの配置の単位です。