READA
モニター・プログラムは READA 要求を発行して、計測機能インターフェースから非同期データを要求することができます。
許可

構文とオプション
計測機能インターフェースの READA 呼び出し構文は以下のとおりです。
CALL DSNWLI,('READA ',ifca,return-area),VL
- ifca
- OPn 宛先および呼び出し開始時の所有権 トークン値 (IFCAOWNR) についての情報が入っています。READA 呼び出しが完了すると、IFCA には、戻りコード、理由コード、 戻り域に移動されたバイト数、エリアが小さ過ぎた場合は戻り域に 移動されなかったバイト数、および失われたレコード数が入ります。
- return-area
- 計測機能により戻される可変長レコードが入ります。戻り域が小さ過ぎると、そのエリアに収容できるだけの出力が
入ります (完全な可変長レコード)。 モニター・プログラムの戻り域が戻されるデータを収納するのに十分な大きさ
でない場合は、理由コード 00E60802 が戻されます。
IFI は、Db2® MSTR アドレス・スペース内の専用ストレージからの要求に応じて、最大 8 つの OP バッファーを割り振ります。IFI は、所有アプリケーションが READA 要求を実行して OP バッファーから アプリケーションの戻り域にデータを転送するまで、これらのバッファーを使用して トレース・データを保管します。 アプリケーションは、START TRACE コマンドを出して OPn また は OPX の宛先を指定すると、OP バッファーの所有者になります。各バッファーのサイズは、256 KB から 16 MB です。IFI は、8 つの各 OP バッファーごとに最大 16 MB のストレージを割り振ります。デフォルトのモニター・バッファー・サイズは MONSIZE サブシステム・パラメーターによって決まります。
