戻り域

すべての READA、READS、およびコマンド要求で、戻り域を 指定しなければなりません。

プログラム固有のプログラミング・インターフェース情報の開始
IFI は戻り域を使用して、コマンド応答、同期データ、および非同期データをモニター・プログラムに戻します。戻り域の内容は、表 1 に示すとおりです。
表 1. 戻り域
16 進オフセット データ・タイプ 説明
0 符号付き 4 バイト整数 戻り域の長さ + 4。これは、モニター・プログラムによって設定しなければ なりません。READA または READS 戻り域の長さに制限はありません。
4 文字、可変長 Db2® は、長さフィールドに続く区域に、収容できるだけの 可変長レコードを入れます。モニター・プログラムの長さフィールドは、Db2 では修正されません。 各可変長トレース・レコードには、2 バイトまたは 4 バイトの長さフィールドがあり、上位ビットに応じて異なります。 上位ビットがオンの場合、長さフィールドは 4 バイトです。 上位ビットがオフの場合は、長さフィールドは 2 バイトです。 この場合、3 番目のバイトはレコードがスパンされているかどうか を示し、そして 4 番目のバイトは予約済みです。

コマンド要求の後で、戻り域の最後の文字は、 改行文字 (X'15') です。

次の表は、IFCID 0306 の場合の戻り域を示しています。
表 2. IFCID 0306 を使用する戻り域
16 進オフセット データ・タイプ 説明
0 符号付き 4 バイトの整数 戻り域の長さ。
4 文字、4 バイト 目印、定数 I306。QW0306OF マッピングの先頭。
8 文字、128 バイト 予約済み
88 符号付き 4 バイトの整数 戻されたデータの長さ。

READA または READS 要求で戻されるデータの宛先ヘッダーは、 マクロ DSNDQWIW または IFCID 306 要求のヘッダー QW0306OF によりマップ されます。 トレース・レコードとそのヘッダーのフォーマットについては、prefix.SDSNIVPD(DSNWMSGS) を 参照してください。READA 呼び出しのための戻り域のサイズの大きさは、START TRACE コマンド上 の BUFSIZE キーワードで指定されたサイズと同じでなければなりません。

コマンド要求時に戻されるデータは可変長セグメント (X'xxxxrrrr' で、 長さは 2 バイト、次の 2 バイトは予約済み です) とそれに続くメッセージ・テキストからなっています。複数のレコードが戻される場合があります。戻り域の最後の文字は、 改行文字 (X'15') です。

モニター・プログラムは、移動されたバイト数 (IFCA 内の IFCABM) と レコード長の合計とを比較し、すべてのレコードが処理された時期を 判別することができます。

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