キャプチャー仕様の追加

CICS® にキャプチャー・ポイントを作成するためには、キャプチャー仕様をイベント仕様に追加します。

このタスクについて

CICS イベント・バインディング・エディターの指示に従うことによって、1 つ以上のキャプチャー仕様を作成できます。 これらの仕様では、以下の項目を指定します。

例えば、任意の READQ TS (一時ストレージ READ) コマンドをイベントの可能性があるものとして指定できます。 次に、インターセプトするコマンドで使用可能なタイプの述部を追加することで、イベントが発生する条件を限定します。

以下の 3 つのタイプの述部を定義できます。
コンテキスト

キャプチャー仕様内の述部は、キャプチャー・ポイントのコンテキストにおけるフィルター処理のために使用されます。

すべてのキャプチャー・ポイントに、述部を指定できるコンテキスト項目が存在します。 例えば、トランザクション ID です。「フィルター」タブに、使用可能なすべてのコンテキスト述部が表示されます。 コンテキスト述部はオプションですが、通常はトランザクション ID または現在のプログラムを指定して、特定のアプリケーションからイベントを出力します。

「コンテキスト」領域は、 イベントのフィルター・オプションを設定するために使用します。 CICS イベント・バインディング・エディター で指定する他の情報に基づいて、適用されないフィールドがあります。 使用可能なコンテキスト述部は、キャプチャー・ポイントに応じて異なります。 指定する述部としては、トランザクション ID、現行プログラム、およびユーザー ID が考えられます。

イベント・オプション

キャプチャー仕様の述部は、CICS コマンドのイベント・オプションの値に対するフィルター処理のために使用されます。

各キャプチャー・ポイントには、述部を指定できるイベント・オプションが可能です。 一部のコマンドには、イベント・オプションは存在しません。イベント・オプションは、特定の EXEC CICS コマンドまたはシステム・イベントのオプションに対応しています。 SEND MAP コマンドの例は、MAP 名です。DB2 接続状況イベントの 1 つの例は、FROM_CONNECTST 状況です。 「フィルター」タブに、キャプチャー・ポイントで使用可能なすべての固定データ値が表示されます。 イベント・オプションの形式は、CICS で認識されます。

アプリケーション・データ

キャプチャー仕様内の述部は、CICS コマンドに指定されているアプリケーション・データに対するフィルター処理のために使用されます。

注: キャプチャー仕様に対して DELETEQ TD または DELETEQ TS のキャプチャー・ポイントが定義されている場合、アプリケーション・データを追加することはできません。

アプリケーション・キャプチャー・ポイントでは、述部を指定できる可変長データ値が可能です。 アプリケーション・データは、特定の EXEC CICS コマンドのオプションに対応しています。 SEND MAP コマンドの例は、FROM フィールドです。「フィルター」タブに、該当するキャプチャー・ポイントの EXEC CICS コマンドで使用可能なすべての変数データ値が表示されます。

アプリケーション・データ述部は、指定されている順序で CICS によって処理されます。 つまり、最初の述部が処理された後、2 番目の述部が処理される、というようになります。

アプリケーション・データは、COMMAREA などのストレージ域、または CICS コマンドでオプションとして渡されたコンテナーで使用されます。これらの領域の形式は CICS に認識されませんが、アプリケーション・プログラムにより認識されます。 多くの場合は、インポートできるソース言語の記述を使用して、形式を記述します。
注: システム・イベントでは、アプリケーション・データは使用されません。

イベント・バインディングの高位定義の際にビジネス管理者が入力した基本イベント・バインディング情報には、イベント仕様が 1 つ含まれます。 このイベント・バインディング情報によって、さらなる処理のために必要になる既知のデータが特定されますが、その場所の詳細は提供されません。 ユーザーは、これらの詳細を提供するために、情報源を指定します。

変更の始まり CICS イベント・バインディング・エディターでは、「情報源」タブに、 ビジネス仕様を満たすために必要な情報の表が表示されます。 この表では、イベント仕様のビジネス情報を示しています。 表内の各項目について、このキャプチャー仕様の情報源を定義する必要があります。変更の終わり

手順

  1. 「仕様」タブで、イベント仕様をクリックします。 右ペインで、強調表示されたイベント仕様の詳細が表示されます。
  2. 「キャプチャー仕様の追加」をクリックします。キャプチャー仕様の追加」ウィンドウが表示されます。
  3. 新規キャプチャー仕様の名前を入力します。 許容文字は、A から Z、a から z、0 から 9、および _ です。 先行ブランクおよび埋め込みブランク文字は使用できません。 ストリングは 0 から 9、または _ で開始することはできません。また、大文字、小文字、大/小文字混合を問わず「xml」(例えば、「Xml」や「xMl」など) で開始することもできません。
  4. オプション: 新規キャプチャー仕様の記述を入力します。
  5. OK」をクリックします。 新規キャプチャー仕様が作成されます。右のエディター・ペインに、3 つのタブ (「キャプチャー・ポイント」「フィルター」、および「情報源」) が開きます。それぞれのタブを使用して、新規キャプチャー仕様を記述する情報を指定します。
  6. 「キャプチャー・ポイント」タブをクリックします。 以下のステップを実行して、キャプチャー・ポイント情報を追加します。
    1. キャプチャー・ポイントを追加する EXEC CICS コマンドを選択するか、「キャプチャー・ポイント」リストから「プログラムの開始」を選択します。 「プログラムの開始」は、CICS プログラムの開始に関連付けられたキャプチャー・ポイントです。
    2. 「前にキャプチャー」または「後にキャプチャー」をクリックします。 キャプチャー・ポイントを EXEC CICS コマンドの前または後にすることを指定できます。 これらの EXEC CICS コマンドのサブセットでは、このオプションは使用できません。
  7. 「フィルター」タブをクリックします。 キャプチャー述部情報を追加する場合には、以下のステップを実行します。
    1. オプション: キャプチャー仕様のアプリケーション・コンテキストを定義します。 選択したキャプチャー・ポイントで使用可能なアプリケーション・コンテキストの述部が表示されます。 「演算子」のオプションを選択して値を入力することにより、述部を指定します。 演算子「すべて」を選択すると、関連付けられた述部にフィルタリングを行わないことが指定されます。 「トランザクション ID」「現在のプログラム」、および「ユーザー ID」の値は、大文字で入力します。
    2. オプション: キャプチャー仕様のアプリケーション・オプションを定義します。 選択したキャプチャー・ポイントで使用可能なアプリケーション・オプションが表示されます。 「演算子」のオプションを選択して値を入力することにより、述部を指定します。 演算子「すべて」を選択すると、関連付けられた述部にフィルタリングを行わないことが指定されます。

      プライマリー述部にすることができるアプリケーション・オプションには、アスタリスク (*) のマークが付けられています。 変更の始まりCICS のパフォーマンスを維持するためには、「演算子」として「等価」を選択し、プライマリー述部に値を指定する必要があります。 例えば、PUT CONTAINER キャプチャー・ポイントでは、 使用可能なアプリケーション・オプションである CONTAINER* に値を指定します。変更の終わり

    3. オプション: キャプチャー仕様のアプリケーション・データを定義します。 アプリケーション・データの述部を追加するには、「追加」をクリックします。 「アプリケーション・データの述部」ウィンドウが表示されます。

      演算子」のオプションを選択し、述部に値を入力します。 演算子「すべて」を選択すると、関連付けられた述部にフィルタリングを行わないことが指定されます。

      述部でテストする変数を定義します。インポートした言語構造体から選択」をクリックしてインポートしたソース・コードの変数の選択の指示に従うことも、「ロケーション」と「タイプ」それぞれについてオプションを選択し、パネル内のアクティブなフィールドを使用して変数をさらに詳しく定義することもできます。 選択したタイプで必要なフィールドのみがアクティブになります。 例えば、「文字」タイプを選択した場合は、「オフセット」「長さ」、および「コード・ページ」の各フィールドのみがアクティブになります。

  8. 「情報源」タブをクリックします。 表内の各情報源に対して以下のステップを実行して、情報源を使用可能なデータ項目にマップします。 イベントでビジネス・データがキャプチャーされない場合には、表に情報源が含まれないことがあります。

    必要ではない場合にはデータをキャプチャーする必要はありません。

    1. 情報源をダブルクリックするか、情報源を選択して「編集」をクリックします。イベントの情報源」ウィンドウが表示されます。
    2. 「コンテキスト」「データ値」、または「可変長データ」から、使用可能なデータ項目を選択します。 可変長データ項目を選択した場合には、インポートした言語構造体から選択」をクリックしてインポートしたソース・コードの変数の選択の指示に従うことも、「ロケーション」と「タイプ」それぞれについてオプションを選択し、パネル内のアクティブなフィールドを使用して変数をさらに詳しく定義することもできます。 選択したタイプで必要なフィールドのみがアクティブになります。 例えば、「文字」タイプを選択した場合は、「オフセット」「長さ」、および「コード・ページ」の各フィールドのみがアクティブになります。

      情報源は、出力されたビジネス情報項目と同じ長さである必要はありません。 CICS によって、必要に応じて値の埋め込みまたは切り捨てが行われます。

タスクの結果

キャプチャー仕様が作成されました。また、「キャプチャー・ポイント」タブの「キャプチャー仕様の削除」をクリックして、「はい」をクリックして確認することで、キャプチャー仕様を削除することもできます。