JCICS のサンプルの配置

CICS Explorer® SDK のサンプル CICS® バンドルを使用して、JCICS サンプルを CICS 領域に配置できます。

始める前に

JCICS サンプルの概要で説明されているように、JCICS サンプル・プロジェクトを作成する必要があります。

このタスクについて

CICS は、zFS から Java アプリケーションをロードして実行するため、コンパイルされたアプリケーションを zFS の適切なディレクトリーに配置する必要があります。 CICS Explorer の z/OS® パースペクティブを使用して、zFS 内に適切なディレクトリーを作成できます。 CICS には、このディレクトリーに対する読み取り権限および実行権限が必要です。

CICS Explorer SDK は、CICS バンドル・プロジェクト内の Java アプリケーションを zFS に配置するためのサポートを提供します。 CICS バンドル・プロジェクトは、単一の単位として論理的に配置および管理される OSGi バンドルのセットをまとめてグループ化します。 サンプルの CICS バンドル・プロジェクトを使用して、JCICS サンプルを CICS 領域に配置できます。

手順

  1. Eclipse IDE で、Java パースペクティブを開きます。
  2. 次のいずれかの選択肢を使用して、「新しいサンプル (New Example)」ウィザードを開きます。
    • Eclipse メニュー・バーで、「ファイル」 > 「新規」 > 「例」をクリックします。
    • 新規ウィザード・アイコンの下矢印をクリックして、「例」をクリックします。
    • Project Explorer ビューで、右クリックして「新規」 > 「例」をクリックします。
  3. 「CICS Java」フォルダーで、「CICS バンドル OSGi サンプル」を選択して「次へ」をクリックします。
  4. 「プロジェクト名」フィールドで、新規プロジェクトの名前を入力します。 デフォルトで、Eclipse はワークスペース内にあるサンプルのフォルダー・ロケーションの後にサンプル名を付けた名前を作成します。例えば、CICS バンドルのデフォルトのプロジェクト名は、com.ibm.cics.server.examples です。
  5. 「終了」をクリックします。 Eclipse は、マニフェストと 3 つのリソースを含む CICS バンドル・プロジェクトを作成します。 これらのリソースは、3 つの OSGi バンドルを参照します。プログラム・ファイルもサンプル・バンドル・プロジェクトの一部です。これを使用して、プロジェクトを CICS に配置してバンドルをインストールできます。
  6. web.osgibundle ファイルを開いて、その内容を確認します。 このファイルは XML 形式で、OSGi バンドルのシンボル名とバージョンが含まれます。また、サンプル JVM サーバーの名前も含まれます。JVM サーバーは、CICS における Java アプリケーションのランタイム環境です。 独自のアプリケーションを作成するときには、このファイル内でターゲット JVM サーバーの名前を提供する必要があります。
  7. 次のようにして、CICS バンドルを zFS に配置します。
    1. CICS バンドル・プロジェクトを右クリックし、「z/OS UNIX ファイル・システムへのエクスポート」を選択します。
    2. 「ファイル・システム内の特定のロケーションにエクスポート」を選択して、「次へ」をクリックします。
    3. 必要に応じて FTP の資格情報を入力します。 接続をそれまでにセットアップしていない場合は、ターゲット・ホスト・マシンへの接続を作成する必要がある場合があります。
    4. CICS バンドルを配置するディレクトリーを参照して、「終了」をクリックします。
    CICS バンドルが、指定されたディレクトリーに配置されます。
  8. CICS SM パースペクティブを開きます。 CICSplex Explorer ビューで、JCICS サンプル・プログラムの実行場所となる CICS 領域を選択します。
  9. サンプル・グループ DFH$OSGI の中にある、JVMSERVER リソース DFH$JVMS をインストールします。 このリソースは、OSGi フレームワークが含まれている CICS 領域にサンプル JVM サーバーを作成します。 このリソース名は、CICS バンドルのマニフェストで指定された JVM サーバーの名前と一致します。 「操作」 > 「Java」 > 「JVM サーバー」をクリックすることにより、JVM サーバーの状況を確認できます。
  10. 「定義」 > 「バンドル定義」をクリックして、「バンドル定義」ビューを開きます。 このビューは、CICS 領域のすべてのバンドル定義をリストします。
  11. 「リソース・グループ定義」ビューで、提供されている DFH$OSGI グループを選択します。 このビューが開いていない場合は、「ウィンドウ」 > 「ビューの表示」を選択して Eclipse パースペクティブでこれを開きます。 「Bundle Definitions」ビューがフィルターに掛けられて、DFH$OSGB リソース定義を表示します。
  12. 属性を編集するために、次のようにしてリソース定義を新しいグループにコピーします。
    1. DFH$OSGB を右クリックして「コピー」を選択します。
    2. 「リソース・グループ定義」ビュー内の任意の場所を右クリックして、「貼り付け」を選択します。
    3. 新しいグループ名を入力して、「OK」をクリックします。
  13. 新しいグループで BUNDLE リソース定義を編集して、配置された CICS バンドルの場所と一致するようにバンドル・ディレクトリーを変更します。
  14. 定義を右クリックして、BUNDLE リソースをインストールします。 「操作」 > 「バンドル」をクリックして、ENABLED 状態でインストールされた BUNDLE を確認できます。また、「Operations」 > 「Java」 > 「OSGi Bundles」をクリックして、OSGi バンドルのリストを確認することもできます。
  15. サンプルを JVM サーバーで実行する場合は、DFH$OSGI サンプル・グループを CICS 領域にインストールします。 このグループには、すべてのサンプルのリソース定義が含まれます。サンプル・リソース BUNDLE および JVMSERVER はインストールされません。同じ名前のリソースを既に作成済みであるためです。 グループをインストールすると、CICS は、サンプルの実行に必要なリソースを作成します。

タスクの結果

サンプルの CICS バンドルが zFS に正常に配置され、JCICS のサンプルを実行するのに必要な CICS リソースが作成されました。

次のタスク

JCICS のサンプルの実行で説明するように、JCICS のサンプルを実行できます。