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