WRITE

モニター・プログラムは WRITE 機能を呼び出して、計測機能インターフェースにデータを書き込むことができます。

許可

プログラム固有のプログラミング・インターフェース情報の開始
WRITE 要求では許可のチェックは行われませんが、 書き込まれる IFCID について Db2® トレースがアクティブでなければなりません。IFCID がアクティブでない場合、要求は拒否されます。WRITE 要求の場合、他の許可検査は適用されません。

構文とオプション

計測機能インターフェースの WRITE 呼び出し構文は以下のとおりです。

CALL DSNWLI,('WRITE   ',ifca,output-area,ifcid-area),VL
書き込み機能は、IFCID 域を指定しなければなりません。 書き込まれるデータは、ユーザーのサイトで定義され、解釈されます。
ifca
呼び出しが正常に終了したかどうかに関する情報が入ります。
output-area
書き込まれるモニター・プログラムの可変長のデータ・レコードが入ります。
ifcid-area
書き込まれるレコードの IFCID が含まれています。 以下の表に示されている IFCID のみが WRITE 機能でサポートされます。無効な IFCID が指定されるかまたは IFCID がアクティブでない場合 (TRACE コマンドにより始動されていない)、データは書き込まれません。
表 1. WRITE 機能に有効な IFCID
IFCID (10 進数) IFCID (16 進数) トレース・タイプ クラス コメント
0146 0092 監査 9 IFCID 146 への書き込み
0151 0097 アカウンティング 4 IFCID 151 への書き込み
0152 0098 統計 2 IFCID 152 への書き込み
0153 0099 パフォーマンス 1 バックグラウンド・イベントおよび IFCID 153 への書き込み
0154 009A パフォーマンス 15 IFCID 154 への書き込み
0155 009B モニター 4 IFCID 155 への書き込み
0156 009C グローバル (保守容易性) 6 ユーザー定義の保守容易性トレースのために予約
変更の始まり0392変更の終わり 変更の始まり0188変更の終わり 変更の始まり監査変更の終わり 変更の始まり9変更の終わり 変更の始まりIFCID 392 への書き込み変更の終わり

プログラム固有のプログラミング・インターフェース情報の終了