アプリケーション・エントリー・ポイントの定義

CICS® バンドル・プロジェクトが CICS アプリケーションの一部である場合、バンドル・マニフェストで適切なアプリケーション入り口点を宣言します。 アプリケーションの入り口点は、アプリケーションへのアクセス・ポイントとなるリソースを識別します。アプリケーション入り口点は、プラットフォームにデプロイされているアプリケーションの異なるバージョンへのユーザーのアクセスを制御するために使用されます。

始める前に

「プロジェクト・エクスプローラー」ビューに CICS バンドル・プロジェクトが表示されている必要があります。

このタスクについて

PROGRAM および URIMAP リソースは、アプリケーション入り口点として識別されます。

プラットフォームにデプロイされたアプリケーションでは、アプリケーション入り口点がアプリケーションの異なるバージョンへのユーザーのアクセスを制御します。 アプリケーション入り口点は、ユーザーに対して選択可能または選択不可として設定できます。 アプリケーションとそのリソースをプラットフォームの CICS 領域に都合の良いときにインストールしておき、CICS バンドルを使用可能にしてインストールを検証できます。 アプリケーション・バージョンをユーザーに提供することを選択する場合、アプリケーション入り口点 (およびそれらが制御するそのアプリケーションのリソース) を呼び出し元が選択できるようにします。

各アプリケーション・エントリー・ポイントはリソースに対して宣言され、オペレーションの名前も指定します。例えば、アプリケーションでの作成、読み取り、更新、または削除のオペレーションに対してアプリケーション入り口点を宣言できます。
  • アプリケーションの 1 つのリソースに対してアプリケーション入り口点は 1 回しか宣言できません。そのとき、1 つの操作を指定します。 同じリソースで複数のアプリケーション入り口点を宣言することはできません。
  • オペレーション名はアプリケーション内で固有である必要があります。
  • オペレーション名は大/小文字が区別されます。 そのため、大/小文字のみが異なるオペレーション名を使用することもできます。

アプリケーション・エントリー・ポイントのリソースを、 アプリケーション・エントリー・ポイントと同じ CICS バンドル内に定義する必要はありません。CICS は、アプリケーションがインストールされた時点で、指定されたリソースにアプリケーション・オペレーションを追加します。 アプリケーション入り口点として宣言された PROGRAM リソースの場合、アプリケーション入り口点は、PROGRAM リソースの場所に関わりなくプログラムへのユーザーのアクセスを制御します。 ただし、アプリケーション入り口点として宣言された URIMAP リソースの場合、アプリケーション入り口点は、URIMAP リソースが定義されているのと同じ CICS バンドルで宣言されている場合のみ、URIMAP リソースへのアクセスを制御します。

CICS バンドルで定義されていないものの、バンドルがデプロイされる CICS 領域に既に存在するリソースに対してアプリケーション入り口点を宣言できます。 バンドルがデプロイされる CICS 領域に自動インストールできる PROGRAM リソースに対して、アプリケーション入り口点を宣言することもできます。 アプリケーションをインストールするときに、アプリケーション入り口点によってターゲットとされたリソースが存在せず、自動インストールできない場合には、アプリケーション入り口点の宣言を含んだ CICS バンドルはインストールされず、警告のマークが付けられます。

プラットフォーム・バンドルの一部としてインストールされた、または実行中のプラットフォームに追加された CICS バンドルでは、バンドル・マニフェストにアプリケーション入り口点の宣言を含めることはできません。 アプリケーション入り口点は、プラットフォームに直接インストールされた CICS バンドルではサポートされません。 また、CICS バンドルおよびそのリソースはインストールされますが、この状態では CICS はアプリケーション入り口点を使用可能にしません。 CICS 領域に直接インストールされたスタンドアロン CICS バンドルにアプリケーション入り口点の宣言を含めて、領域レベル・ポリシーのスコープを使用可能にすることができます。

アプリケーション入り口点は、アプリケーション入り口点に指定されたリソースへのユーザーのアクセスのみを制御します。 アプリケーションにアプリケーション入り口点として指定されていない公開リソースが含まれる場合、アプリケーションがインストールされ使用可能にされると、プラットフォームまたは CICS 領域にインストールされたその他のアプリケーションは、そのアプリケーションの選択可能性に関する状況に関わりなくそれらのリソースにアクセスすることができます。 その他のアプリケーションは、アプリケーション・バージョンの専用リソースにアクセスすることはできません。

アプリケーション入り口点として定義されたプログラムには、使用する環境で固有の PROGRAM リソース名を指定する必要があります。 アプリケーションの外側からこれらのプログラムを呼び出せるようにするには、それらは公開リソースである必要があります。 専用 PROGRAM リソースに対するアプリケーション入り口点を含むアプリケーションを使用可能にすると、アプリケーション入り口点として指定された PROGRAM リソースは専用リソースから公開リソースに変更されます。 そのため PROGRAM リソースは、CICS 領域にインストールされた公開プログラムと同じ名前、または別のインストール済みアプリケーションによってアプリケーション入り口点として定義された公開プログラムと同じ名前を持つ可能性があります。 アプリケーション入り口点として定義された同じプログラムの複数バージョンを同じアプリケーションの複数バージョンに対してロードすることができます。

URIMAP リソースを CICS バンドルに定義すると、アプリケーション入り口点の宣言を使用して、URIMAP リソースによって提供されるサービスへのユーザーのアクセスを制御できます。 この機能のために、アプリケーション入り口点を宣言して、URIMAP リソースを同じ CICS バンドルに定義します。 この場合、アプリケーションをインストールして使用可能にしても、URIMAP リソースによって提供されるサービスは、呼び出し元からまだ選択できません。 サービスをユーザーに提供することを選択する場合、CICS Explorer® または EXEC CICS SET BUNDLE コマンドを使用して、アプリケーション入り口点および URIMAP リソースを含む CICS バンドルを選択可能にします。 このアクションによって、呼び出し元がアプリケーション入り口点 (および URIMAP リソースによって提供されるサービス) を選択できるようになります。

アプリケーション入り口点に URIMAP リソースによって提供されるサービスへのアクセスを制御させないようにするには、アプリケーション入り口点を宣言して、URIMAP リソースを別の CICS バンドルに定義します。 アプリケーションの外側に定義され、依存関係として宣言された URIMAP リソースを、アプリケーションに対してアプリケーション入り口点として宣言 (またはインポート) することもできます。 これらのいずれかの場合、URIMAP リソースをインストールおよび使用可能にするとすぐに、ユーザーはサービスを選択できるようになります。

手順

  1. CICS バンドル・プロジェクトと META-INF フォルダーを展開します。
  2. cics.xml ファイルを開いて、CICS バンドル・マニフェスト・エディターを表示します。
  3. 「入り口点」タブをクリックして、バンドルのアプリケーション・エントリー・ポイントのリストを開きます。
  4. 「追加」をクリックして、アプリケーションのアプリケーション・エントリー・ポイントを定義します。 「アプリケーション入り口点の作成」ダイアログが表示されます。
    1. アプリケーション・オペレーションの名前を入力します。 オペレーション名では、大/小文字が区別されます。 また、a-z、A-Z、0-9._#@- の文字を含めることができ、最大 64 文字の長さにできます。 オペレーション名がアプリケーション内で固有であることを確認してください。 アプリケーションに重複したオペレーション名を指定すると、その名前を選択可能にすることはできません。
    2. リソース・タイプを選択します。
    3. CICS リソースの名前を入力します。
  5. 「OK」をクリックして、アプリケーション・エントリー・ポイントを保管します。

タスクの結果

アプリケーションの異なるバージョンへのユーザー・アクセスの制御と同様、タスクのアプリケーション・コンテキストを作成するためにアプリケーション入り口点が使用されます。 アプリケーションがデプロイされた時点で、指定したリソースにオペレーション名が追加され、そのリソースを使用するタスクについてアプリケーション・コンテキスト・データが生成されます。

タスクがアプリケーション入り口点を持つリソースを呼び出すと、CICS はアプリケーション・コンテキストを作成します。 それは、そのタスクに関連付けられた、また呼び出す後続のプログラムや開始するタスクに関連付けられた、初期アプリケーション・コンテキストになります。 アプリケーション・コンテキストは、プラットフォーム、アプリケーション、アプリケーション・バージョン、およびオペレーションを識別します。 タスクにアプリケーション・コンテキストが既に存在する場合には、それが現行アプリケーション・コンテキストになります。 ただし、呼び出し元タスクのアプリケーション・コンテキストをポリシーのモニターやスコープ設定に使用できます。 アプリケーション・コンテキスト・データは、以下の目的で使用できます。
  • 初期アプリケーション・コンテキストは、CICS 領域と複数のタスク全体で、アプリケーションまたは特定のアプリケーション・オペレーションがどれほどの量のリソースを使用しているかをモニターし、測定するために使用されます。
  • 初期アプリケーション・コンテキストは、アプリケーションの一部であるタスクに対してポリシーを適用することにより、タスクの動作を管理するためのしきい値条件を定義するために使用されます。
  • 初期または現行アプリケーション・コンテキストを CICS Explorer のトランザクション・トラッキング機能で使用して、アプリケーション関連の問題を迅速に識別して診断することができます。