イベントが使用可能な EXEC CICS API コマンドのいずれかがアプリケーションによって発行されるときに、イベントが発行されるように指定できます。 また、アプリケーション・プログラムが開始されるときに発行されるように指定することもできます。 イベントが使用可能な EXEC CICS® コマンドはキャプチャー・ポイントに示されています。 限られた一連の CICS モジュールもイベントが使用可能です。 そのため、例えば、Atom サポートから出されるファイルや一時ストレージのコマンド、 CICS WebSphere® MQ ブリッジ・プログラムによって発行された EXEC CICS LINK コマンド、CICS サンプルおよび CECI トランザクションのコマンドから、イベントをキャプチャーすることができます。
キャプチャー仕様は、フィルター (トランザクション ID、プログラム名、EXEC CICS コマンド・オプション値など) を使用して、イベント出力の基準を定義します。 このキャプチャー仕様は、コマンドに関連付けられたアプリケーション・データをフィルター処理することでさらに詳細化できます。 例えば、10,000 を超えていなければならないオーダー値を含む COMMAREA フィールドを指定できます。 また、キャプチャー仕様では、キャプチャーされるデータの場所も定義されます。
アプリケーション・ロジック内のイベントの位置は、指定方法に依存します。 CICS アプリケーションに同じ EXEC CICS API コマンドの 2 つのインスタンスが含まれていて、フィルター仕様で 2 つのコマンドが区別されない場合、 イベントは、両方のコマンドが実行されたときに出力されます。同じ EXEC CICS API コマンドが 2 つのアプリケーションで発生し、トランザクション ID やプログラム名にフィルターが存在しない場合には、イベントは、両方のアプリケーションが実行されたときに出力されます。
イベントはプログラム開始時 (PGMINIT) に、および以下の EXEC CICS API コマンドでキャプチャーできます。 以下の表に指定可能なキャプチャー・ポイントを示します。
キャプチャー・ポイント | プライマリー述部 | フィルター述部 | キャプチャー・データ | ||
---|---|---|---|---|---|
コンテキスト | イベント・オプション | イベント・オプション | アプリケーション・データ | ||
CONVERSE | なし | トランザクション ID |
なし | FROM |
なし |
DELETE FILE | FILE | トランザクション ID |
FILE | FILE | RIDFLD |
DELETEQ TD | QUEUE | トランザクション ID |
QUEUE | QUEUE | なし |
DELETEQ TS | QNAME | トランザクション ID |
QNAME | QNAME | なし |
INVOKE SERVICE | SERVICE | トランザクション ID |
SERVICE |
SERVICE |
CHANNEL |
LINK PROGRAM | PROGRAM | トランザクション ID |
PROGRAM |
PROGRAM |
COMMAREA |
PROGRAM INIT | PROGRAM | トランザクション ID |
PROGRAM |
なし | COMMAREA |
PUT CONTAINER | CONTAINER | トランザクション ID |
CONTAINER |
CONTAINER |
FROM |
READ | FILE | トランザクション ID |
FILE |
FILE | RIDFLD |
READNEXT | FILE | トランザクション ID |
FILE |
FILE | RIDFLD |
READPREV | FILE | トランザクション ID |
FILE |
FILE | RIDFLD |
READQ TD | QUEUE | トランザクション ID |
QUEUE | QUEUE | INTO-SET |
READQ TS | QNAME | トランザクション ID |
QNAME | QNAME | INTO-SET |
RECEIVE | なし | トランザクション ID |
なし | なし | INTO-SET |
RECEIVE MAP | MAP | トランザクション ID |
MAP |
MAP |
INTO-SET |
RETRIEVE | なし | トランザクション ID |
なし | なし | INTO-SET |
RETURN | なし | トランザクション ID |
TRANSID |
TRANSID |
COMMAREA |
REWRITE | FILE | トランザクション ID |
FILE | FILE | FROM |
SEND | なし | トランザクション ID |
なし | なし | FROM |
SEND MAP | MAP | トランザクション ID |
MAP |
MAP |
FROM |
SEND TEXT | なし | トランザクション ID |
ALARM | なし | FROM |
SIGNAL EVENT 1 | EVENT | トランザクション ID |
EVENT |
EVENT |
FROM |
START | TRANSID | トランザクション ID |
TRANSID |
TRANSID |
FROM |
WEB READ | なし | トランザクション ID |
なし | なし | FORMFIELD |
WEB READNEXT | なし | トランザクション ID |
なし | なし | FORMFIELD |
WRITE FILE | FILE | トランザクション ID |
FILE | FILE | RIDFLD FROM |
WRITE OPERATOR | なし | トランザクション ID |
なし | なし | TEXT 2 |
WRITEQ TD | QUEUE | トランザクション ID |
QUEUE | QUEUE | FROM |
WRITEQ TS | QNAME | トランザクション ID |
QNAME | QNAME | FROM |
XCTL | PROGRAM | トランザクション ID |
PROGRAM |
PROGRAM |
COMMAREA |
すべてのキャプチャー・ポイントは、同じコンテキスト・キャプチャー項目 PROGRAM、TRANSID、および USERID を定義します。