「情報源」タブ

このキャプチャー仕様によって出力済みビジネス情報が取得される場所を定義するには、「情報源」タブを使用します。

このタブは、「イベント・バインディング」タブで定義したビジネス情報項目の表で構成されています。 出力済みビジネス情報の項目ごとに、情報源を入力する必要があります。

このタブは、イベント仕様に関連したビジネス情報項目を、当該キャプチャー・ポイントの使用可能なデータ項目にマップする場合に使用します。

「情報源」タブのイメージ

「情報源」表のフィールドは、「情報源の編集」パネルで編集できるオプションをまとめたものです。

アプリケーションのキャプチャー・ポイントの「情報源の編集」パネル

ある情報源について「情報源の編集」パネルを開くには、表内で情報源を選択して「編集」をクリックするか、または情報源をダブルクリックします。
図 1. このイメージは「情報源」パネルを示したものです。 このパネルは、アプリケーションのキャプチャー・ポイントに REWRITE が選択されている場合に表示される可能性があります。
アプリケーションのキャプチャー・ポイントの「情報源の編集」パネルのイメージ

「有効なデータ」ペインのフィールド

「情報源の編集」パネルの「有効なデータ」ペインには、以下のフィールドがあります。
コンテキスト
コンテキスト・フィールドは、アプリケーション・コンテキストに関するデータをキャプチャーするために使用します。 有効なコンテキストの選択肢は次のとおりです。
PROGRAM
TRANSID
USERID
イベント・オプション
イベント・オプションは、CICS コマンドのオプション値をキャプチャーするために使用します。 イベント・オプションは、指定されているキャプチャー・ポイントによって異なります。
アプリケーション・データ
キャプチャー仕様の述部は、CICS コマンドに指定されたアプリケーション・データのフィルタリングに使用します。 アプリケーション・データは、指定されているキャプチャー・ポイントによって異なります。 「情報源の編集」パネルの右側にあるコピーブックのインポートとフォーマットのオプションは、「有効なデータ」ペインでアプリケーション・データの項目が選択されている場合のみ使用できます。
「情報源の編集」パネルの「有効なデータ」ペインで選択するオプションに基づいて、「情報源の編集」パネルの残りのペインでは以下のフィールドが有効になります。
コンテナー
CICS チャネルのコンテナーを指定します。 コンテナー・フィールドは、アプリケーション・データにチャネルが指定されている場合のみ選択できます。 その他のすべての状態では、すべてこのフィールドは使用不可になっています。

言語構造をインポートする場合は、「インポート済み言語構造から選択」をクリックします。 次に、言語構造からキャプチャーするフィールドを選択できます。 この方式を使用する場合、「タイプ」「オフセット」、および「長さ」の各フィールドには、自動的に値が入力されます。 あるいは、「タイプ」「オフセット」、および「長さ」の値を自分で指定することも可能です。

タイプ
アプリケーション・データの述部のデータ型を指定します。 以下のデータ型を選択可能です。
  • 2 進浮動小数点
  • 文字
  • NULL 終了文字
  • 10 進浮動小数点
  • 16 進数
  • NULL 終了の 16 進数
  • 16 進浮動小数点
  • パック 10 進数
  • 符号付きハーフワード
  • 符号付きフルワード
  • 符号なしハーフワード
  • 符号なしフルワード
  • ゾーン 10 進数
オフセット
データが始まる、先頭からの距離を指定します。 オフセット 0 は、フィールドの始まりです。
長さ
キャプチャーされるフィールドの長さ。 0 という長さは、データ域またはコンテナーの最後までのキャプチャーを意味します。 この値は、例えばコンテナーの内容を長さに関係なく出力する場合に便利です。
精度
数値および科学的記数法のビジネス情報項目の精度を選択します。他のビジネス情報項目に対しては、このフィールドは無効になっています。
コード・ページ
コード・ページを選択します。 このフィールドは、別のソースから発生したアプリケーション・データなど、一部のビジネス情報項目に対しては使用不可になっています。

システムのキャプチャー・ポイントの「情報源の編集」ウィンドウ

ある情報源について「情報源の編集」パネルを開くには、表内で情報源を選択して「編集」をクリックするか、または情報源をダブルクリックします。 CICS では、すべての情報源の形式が認識されています。
図 2. このイメージは「情報源」パネルを示したものです。 このパネルは、システムのキャプチャー・ポイントに FILE ENABLE が選択されている場合に表示される可能性があります。
システムのキャプチャー・ポイントの「情報源の編集」パネルのイメージ
「情報源の編集」パネルの「有効なデータ」ペインには、以下のフィールドがあります。
コンテキスト
コンテキスト・フィールドは、システム・コンテキストに関するデータをキャプチャーするために使用します。 有効なコンテキストの選択肢は次のとおりです。
TRANSID
USERID
システム・イベント・データ
システム・イベント・データのフィールドは、発生したシステム・イベントに関するデータをキャプチャーするために使用します。 システム・イベント・データは、指定されているキャプチャー・ポイントによって異なります。

「キャプチャー・ポイント」タブの「システムのキャプチャー・ポイント」ペインで選択するオプションに基づいて、「情報源の編集」パネルでは以下のオプションが有効になります。

DB2 CONNECTION STATUS の情報源

表 1.
オプション 説明
DB2ID

グループ接続を使用していない場合、このオプションは、CICS DB2 接続の接続先である DB2 サブシステムの名前を返します。 または、CICS DB2 接続が接続されていない場合、CICS の接続先に指定した DB2 サブシステムの名前を返します。

詳しくは、INQUIRE DB2CONN の DB2ID を参照してください。

DB2GROUPID

グループ接続を使用している場合、このオプションは、指定した DB2 サブシステムのデータ共有グループまたはサブグループの名前を返します。

詳しくは、INQUIRE DB2CONN の DB2GROUPID を参照してください。

DB2RELEASE

CICS の接続先である DB2 サブシステムのバージョンとリリース・レベルを示す 4 文字の値を返します。

詳しくは、INQUIRE DB2CONN の DB2RELEASE を参照してください。

FROM_CONNECTST
CICS DB2 接続の状況を表す文字ストリング。 可能な値には以下のものがあります。
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

詳しくは、INQUIRE DB2CONN の CONNECTST を参照してください。

TO_CONNECTST
CICS DB2 接続の状況を表す文字ストリング。 可能な値には以下のものがあります。
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

詳しくは、INQUIRE DB2CONN の CONNECTST を参照してください。

FILE ENABLE STATUS の情報源

表 2.
オプション 説明
FILE

問い合わせるファイルの 8 文字の名前を指定します。

詳しくは、INQUIRE FILE の FILE を参照してください。

DSNAME

FILE 定義と関連付けられた BDAM データ・セットまたは VSAM オブジェクトの 44 文字の名前を戻します。

詳しくは、INQUIRE FILE の DSNAME を参照してください。

FROM_ENABLESTATUS
アプリケーション・プログラムがファイルにアクセスできるかどうかを識別する文字ストリング。 可能な値には以下のものがあります。
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

詳しくは、INQUIRE FILE の ENABLESTATUS を参照してください。

TO_ENABLESTATUS
アプリケーション・プログラムがファイルにアクセスできるかどうかを識別する文字ストリング。 可能な値には以下のものがあります。
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

詳しくは、INQUIRE FILE の ENABLESTATUS を参照してください。

OPENSTATUS
ファイルが開いているか、閉じているか、または遷移状態にあるかを識別する文字ストリング。 可能な値には以下のものがあります。
  • CLOSED
  • CLOSEREQUEST
  • OPEN

詳しくは、INQUIRE FILE の OPENSTATUS を参照してください。

FILE OPEN STATUS の情報源

表 3.
オプション 説明
FILE

問い合わせるファイルの 8 文字の名前を指定します。

詳しくは、INQUIRE FILE の FILE を参照してください。

DSNAME

FILE 定義と関連付けられた BDAM データ・セットまたは VSAM オブジェクトの 44 文字の名前を戻します。

詳しくは、INQUIRE FILE の DSNAME を参照してください。

FROM_OPENSTATUS
ファイルが開いているか、閉じているか、または遷移状態にあるかを識別する文字ストリング。 可能な値には以下のものがあります。
  • CLOSED
  • CLOSEREQUEST
  • OPEN

詳しくは、INQUIRE FILE の OPENSTATUS を参照してください。

TO_OPENSTATUS
ファイルが開いているか、閉じているか、または遷移状態にあるかを識別する文字ストリング。 可能な値には以下のものがあります。
  • CLOSED
  • CLOSEREQUEST
  • OPEN

詳しくは、INQUIRE FILE の OPENSTATUS を参照してください。

ENABLESTATUS
アプリケーション・プログラムがファイルにアクセスできるかどうかを識別する文字ストリング。 可能な値には以下のものがあります。
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

詳しくは、INQUIRE FILE の ENABLESTATUS を参照してください。

TASK THRESHOLD の情報源

表 4.
オプション 説明
FROM_TASKS

イベントの前の接続済みタスクの数を指定します。

TO_TASKS

イベントの後の接続済みタスクの数を指定します。

MAXTASKS

この CICS において、任意の一時点でディスパッチの資格があるタスクの最大数を返します。

詳しくは、INQUIRE SYSTEM の MAXTASKS を参照してください。

PERCENT_MAXTASKS

超過したしきい値を最大タスク数のパーセンテージで指定します。

TRANCLASS TASK THRESHOLD の情報源

表 5.
オプション 説明
TRANCLASS

問い合わせるトランザクション・クラスの 8 文字の名前を指定します。 クラスが CICS の初期リリースで使用されていた番号付きクラスのいずれかである場合、クラスの名前は DFHTCLnn となります。 ここで、nn は 2 桁のクラス番号です。

詳しくは、INQUIRE TRANCLASS の TRANCLASS を参照してください。

FROM_ACTIVE

イベントの前の、トランザクション・クラス内のアクティブ・タスクの数を返します。

TO_ACTIVE

イベント後の、トランザクション・クラス内のアクティブ・タスクの数を返します。

MAXACTIVE

トランザクション・クラス内で並行して実行できるタスクの最大数を返します。

詳しくは、INQUIRE TRANCLASS の MAXACTIVE を参照してください。

PERCENT_MAXACTIVE

超過したしきい値を最大アクティブ・タスク数のパーセンテージで指定します。

UNHANDLED TRANSACTION ABEND の情報源

表 6.
オプション 説明
TRANSACTION

未処理のトランザクションの異常終了を発行したトランザクション ID を指定します。

ABCODE

4 文字のトランザクション・ダンプの異常終了コードを指定します。

詳しくは、キャプチャー仕様の追加を参照してください。