付録B.3 HiRDBクライアント
HiRDBクライアントでは，SQLトレースファイル，エラーログファイル，および再接続トレースファイルに，コネクションIDやコネクト通番などの情報が出力されます。
SQLトレースファイル，エラーログファイル，および再接続トレースファイルの取得方法と出力形式について説明します。
- 〈この項の構成〉
(1) SQLトレースファイル
実行したUAPのSQLトレース情報を出力したトレースファイルです。SQLの実行終了時に出力されます。
UAP実行時にSQLエラーが発生した場合，SQLトレースファイルを参照すると，エラーの原因となるSQLを特定できます。
- コネクションIDが出力される条件
-
次の条件を満たしている場合，SQLトレースファイルにコネクションIDが出力されます。
-
クライアント環境定義のPDCLTPATHおよびPDSQLTRACEに値を指定している。
なお，クライアント環境定義の設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
-
(a) 取得方法
クライアント環境定義のPDCLTPATHに指定したディレクトリに格納されます。
(b) 出力形式
次に示す形式で，サーバ名称，コネクト通番，およびサーバのプロセスIDが出力されます。
（省略） ： CONNECTION STATUS： CURHOST（接続先ホスト名） CURPORT（接続ポート番号） SRVNAME（サーバ名称） CNCTNO（コネクト通番） SVRPID（サーバのプロセスID） CLTPID（UAPのプロセスID） CLTTID（UAPのスレッド番号） ： （省略）
SQLトレースファイルには，SQL文，SQL実行時刻やSQL文中の変数に設定した値なども出力されます。出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
(2) エラーログファイル
クライアントとHiRDBサーバ間の通信処理中，またはX/Openで規定したXAインタフェースでエラーが発生した場合のエラー情報を出力したログファイルです。SQL実行時，通信処理時，またはX/Openで規定したXAインタフェース関数実行時でエラーが発生したときに出力されます。
- コネクションIDが出力される条件
-
次の条件を満たしている場合，エラーログファイルにコネクションIDが出力されます。
-
クライアント環境定義のPDCLTPATHおよびPDUAPERLOGに値を指定している。
なお，設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
-
(a) 取得方法
クライアント環境定義のPDCLTPATHに指定したディレクトリに格納されます。
(b) 出力形式
次に示す形式で，SQLトレースにサーバのプロセスIDが出力されます。
エラーログ先頭識別子（'>>'または'>'） UAPのプロセスID UAPのスレッド番号 サーバのプロセスID エラーログカウンタ （以降省略）
出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
エラーログ情報には，接続情報のほか，エラー取得時刻，SQLCODEやエラーが発生したSQLのオペレーションコードなどが出力されます。
(3) 再接続トレースファイル
HiRDBクライアントの自動再接続機能で再接続が実行された場合，HiRDBが内部的に管理している接続ハンドルの値，再接続前の接続情報，再接続後の接続情報，および再接続時刻を出力したトレースファイルです。自動再接続機能で自動的に接続が実行された場合に出力されます。
- コネクションIDが出力される条件
-
次の条件を満たしている場合，再接続トレースファイルにコネクションIDが出力されます。
-
クライアント環境定義のPDCLTPATHおよびPDSQLTRACEに値を指定している。
-
HiRDBの自動再接続機能を使用している。
なお，設定方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
-
(a) 取得方法
クライアント環境定義PDCLTPATHに指定したディレクトリに再接続トレースファイルが格納されます。格納されるファイル名称は，pdrcnct1.trcおよびpdrcnct2.trcです。
(b) 出力形式
再接続トレースは次の形式で出力されます。
接続ハンドルの値 再接続結果（SまたはF） 再接続開始日時 - 再接続完了日時 再接続前の接続情報 => 再接続後の接続情報
コネクションIDは再接続後の接続情報として出力されます。
出力形式の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。
再接続トレースファイルの出力例を次に示します。背景色付きの太字はコネクションIDです。
40004250 S 2004/04/12 11:10:36.766 - 2004/04/12 11:10:41.846 sds:9:23763 => sds:10:23750 40004250 S 2004/04/12 11:11:07.491 - 2004/04/12 11:11:12.547 sds:10:23750 => sds:11:23765 40004850 F 2004/04/12 11:17:58.285 - 2004/04/12 11:18:23.395 sds:14:23751 => 40005050 S 2004/04/12 11:27:35.098 - 2004/04/12 11:27:40.152 sds:1:24414 => sds:2:24418