キャプチャー仕様の追加

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

このタスクについて

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

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

以下の 3 つのタイプの述部を定義できます。
アプリケーション・コンテキスト
すべてのキャプチャー・ポイントに、述部を指定できるコンテキスト項目が存在します。 例えば、トランザクション ID です。「フィルター」タブに、使用可能なすべてのアプリケーション・コンテキスト述部が表示されます。 アプリケーション・コンテキスト述部はオプションですが、通常はトランザクション ID または現在のプログラムを指定して、特定のアプリケーションからイベントを出力します。
アプリケーション・コマンド・オプション
キャプチャー・ポイントに指定可能な各 EXEC CICS コマンドには、述部を指定できるアプリケーション・コマンド・オプションが存在する場合があります。 一部のコマンドには、アプリケーション・コマンド・オプションは存在しません。 アプリケーション・コマンド・オプションは、特定の EXEC CICS コマンドのオプションに対応しています。 SEND MAP コマンドの例は、MAP 名です。「フィルター」タブに、該当するキャプチャー・ポイントの EXEC CICS コマンドで使用可能なすべての固定データ値が表示されます。

アプリケーション・コマンド・オプションの形式は、CICS で認識されます。

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

アプリケーション・データ述部は、 指定された順序で CICS によって処理されます。例えば、最初の述部が処理されると、2 番目が処理され、 その後もそれ以降が同様に処理されていきます。

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

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

CICS イベント・バインディング・エディターでは、「情報源」パネルに、 ビジネス仕様を満たすために必要な情報の表が表示されます。 この表は、ビジネス管理者がイベント仕様を入力した際に、部分的に値が設定されています。 表内には空きスペースがあります。キャプチャーする必要があるデータの場所を 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 によって、必要に応じて値の埋め込みまたは切り捨てが行われます。

タスクの結果

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