4.3.5　使用上の注意

APIトレースを取得するときは，次の点に注意してください。

APIトレースファイルの最大個数

APIトレースファイルはプロセス当たり最大128個生成されます。この個数を超えた場合，イベントログまたはsyslogにメッセージKFCB30401-Wが出力されます。このメッセージが出力されたプロセスのAPIトレースは取得されません。

APIトレースファイル解析コマンドの発行タイミング

取得したAPIトレースは原則的にアプリケーションプログラムの停止後に解析するものとし，アプリケーションプログラム実行中の解析結果は保証されません。ただし，アプリケーションプログラム実行中に解析しても，アプリケーションプログラムに影響はありません。

APIトレース取得対象オブジェクト

削除されたオブジェクトに対するAPIコールには例外が発生しますが，この例外に関するAPIトレースは取得できません。また，Resource，SubtransactionAwareResource，Synchronization，およびRecoveryCoordinatorオブジェクトではAPIトレースは取得されません。

APIトレースが取得されるプロセス

APIトレースは，呼び出されたオブジェクトを作成したプロセスで取得されます。

例えば，次の図に示すような構成の明示的プロパゲーション時のインターポジションでは，サーバによるget_coordinatorオペレーションの呼び出しは，クライアントで作成されたControlオブジェクトに対して行われるため，APIトレースはクライアントプロセスで取得されます。同様に，get_txcontextオペレーションの呼び出しもクライアントプロセスで取得されます。

図4‒1　サーバでのAPIコールがクライアントで取得される例

ページの先頭へ