JCICS のサンプルの作成

CICS® で実行できる Java™ アプリケーションの開発方法について理解するため、JCICS サンプル・プロジェクトを作成してください。

手順

  1. Eclipse IDE で、Java パースペクティブを開きます。
  2. CICS の最新のリリースにターゲット・プラットフォームを設定して、JCICS サンプルを処理します。 そうでない場合、ワークスペースにサンプルを作成するときにコンパイル・エラーが発生します。
    1. ワークベンチ・メニュー・バーで、「ウィンドウ」 > 「設定」をクリックします。
    2. 「プラグイン開発」を展開し、「ターゲット・プラットフォーム」をクリックします。
    3. 「追加」をクリックして、ターゲット定義を作成します。
    4. 「テンプレート」をクリックし、 リストから「CICS TS V5.2」を選択します。
    5. ウィザードで「次へ」をクリックし、「終了」をクリックします。
    6. ターゲット定義を選択して、[OK] をクリックします。
  3. サンプルのプラグイン・プロジェクトを作成するには、以下のいずれかの方法を使用して「新しいサンプル (New Example)」ウィザードを開きます。
    • Eclipse メニュー・バーで、「ファイル」 > 「新規」 > 「例」をクリックします。
    • 「新規」アイコンで下矢印をクリックし、「サンプル (Example)」をクリックします。
    • 「プロジェクト・エクスプローラー (Project Explorer)」ビューまたは「パッケージ・エクスプローラー (Package Explorer)」ビューで右クリックし、「新規」 > 「サンプル (Example)」をクリックします。
  4. 「CICS サンプル」 > 「Java」フォルダーで、「CICS Hello サンプル」を選択し、「次へ」をクリックします。
    Java フォルダーの利用できるサンプルを持つウィザードを示す画面取り。
    • CICS API のサンプルは、一時データ・キュー、一時記憶域キュー、および Java プログラムのチャネルと COMMAREA の使用方法を示しています。
    • CICS バンドル OSGi サンプルは、CICS に配置するための CICS バンドルの作成方法を示します。
    • CICS Hello のサンプルは、CICS で単純な Hello World のテストを行う 2 つの方法を示しています。
    • CICS Web サンプルは、クラスを使用して Web ブラウザーと対話する方法を示しています。
  5. 「プロジェクト名」フィールドで、新規プロジェクトの名前を入力します。 デフォルトで、Eclipse はワークスペース内にあるサンプルのフォルダー・ロケーションの後にサンプル名を付けた名前を作成します。 例えば、Hello World のサンプルのデフォルトのプロジェクト名は、com.ibm.cics.server.examples.hello です。
  6. 「終了」をクリックします。 Eclipse は、OSGi バンドルとして JCICS Hello World サンプルを含むプラグイン・プロジェクトを作成します。
    ヒント: プロジェクトがビルドされず、次のエラーが発生した場合は、ステップ 2 を正常に完了したことを確認してください。
    バンドル 'com.ibm.cics.server' を解決できません
  7. Package Explorer ビューでプロジェクトを展開します。
    Hello World の実例プロジェクトが展開された Package Explorer ビューの画面取り。
    • 「プラグインの依存関係 (Plug-in Dependencies)」フォルダーに、OSGi バンドルの依存関係が含まれます。 この例では、バンドルは JCICS を含む OSGi バンドルで依存関係を持っています。また、この情報がプロジェクトのマニフェストに取り込まれます。
    • src フォルダーには、サンプルの Java ソースが含まれています。ソース・ファイルを参照すると、使用されている JCICS クラスを確認できます。コンテキスト・ヘルプを使って特定のクラスについて調べることもできます。 さらに、Javadoc ビューを開いて、選択したコンテンツ (1 つのメソッド、クラスなど) に関する API 詳細説明を確認することもできます。
    • 「META-INF」フォルダーには、プロジェクトのマニフェストが含まれます。 マニフェストには、OSGi バンドルを説明する OSGi ヘッダーが含まれます。
  8. 「新しいサンプル (New Example)」ウィザードを使用して、CICS API および CICS Web サンプル用のプラグイン・プロジェクトを作成します。 Java ソースを表示すると、JCICS クラスがプログラムや Web アプリケーションと連携するためにどのように使用されるかを理解できます。

タスクの結果

JCICS サンプル用として Eclipse で 3 つのプラグイン・プロジェクトを作成しました。これらのプロジェクトには、プラグインの依存関係やターゲット Java 環境を含む、OSGi バンドル・パッケージ化についての情報が含まれます。