READA

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

許可

プログラム固有のプログラミング・インターフェース情報の開始
READA 要求では、アプリケーション・プログラムは、指定された宛先バッファーを 所有していなければなりません。所有していないと、要求は拒否されます。 ストレージ・バッファーの所有権を獲得するためには、OPn 宛先に 対し START TRACE を出してください。 処理の 1 次許可 ID、またはいずれか の 2 次許可 ID が、MONITOR1 または MONITOR2 特権を持っていない場合は、 要求は拒否されます。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 サブシステム・パラメーターによって決まります。

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