Cosminexus DABroker Libraryでは，スプール情報のほかに次のJDBCドライバのトレースも取得できます。

• JDBCインタフェースメソッドトレース
• Cosminexus DABroker Libraryのイベントトレース

ただし，これらのトレースを取得するためには，アプリケーション開発時にJDBCドライバのトレース取得のための設定をしておく必要があります。設定方法については，マニュアル「Cosminexus　機能解説」のデータベース接続の設定に関する説明を参照してください。

Cosminexus DABroker Libraryでは，スプール情報として，メッセージログ，拡張データベースアクセストレース，Exceptionトレースログなどを取得できます。環境設定ユティリティ（Windowsの場合）またはCosminexus DABroker Library動作環境定義ファイル（UNIXの場合）で，メッセージログ，拡張データベースアクセストレースのファイルサイズなどを設定してください。環境設定ユティリティまたはCosminexus DABroker Library動作環境定義ファイルの設定については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

また，Exceptionトレースログを取得するためには，運用開始前に取得のための設定が必要です。ここでは，Exceptionトレースログ取得の設定について説明します。

Exceptionトレースログ取得の設定では，次の内容を設定します。

• トレース取得レベル
• ファイル出力先
• ファイル出力情報量
• メモリ内取得情報量

それぞれの設定方法について説明します。

(a)　トレース取得レベル

Exceptionトレースログは，メソッド実行時に，SQLException，BatchUpdateException，またはXAExceptionが発生した場合に出力されます。Exceptionトレースログを出力するメソッドには，メソッドごとにトレース取得レベルが定義されています。出力するトレース取得レベルを指定することで，目的に応じた内容のトレースを出力できるようになります。

• 設定方法
  トレース取得レベルは，次の環境変数で指定します。
  

  環境変数名	説明
  DAB_TRACELEVEL	トレース取得レベルとして，1〜5を指定します。ただし，トレース取得レベル4は現在未使用であり，4が指定された場合は3と同じ動きとなります。 ここでは，どのトレース取得レベルまでログを取得するかを指定します。例えば，トレース取得レベル3を指定した場合は，トレース取得レベル1および2の内容が取得できます。トレース取得レベル5が指定された場合は，内部呼び出しを含め，ログ取得対象メソッドをすべて取得します。 指定を省略した場合，または不正な値を指定した場合は，トレース取得レベルとして，1を仮定します。 ログを取得するメソッドは，指定された値で取得されるメソッドすべてとなります。 指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

  　
  
• トレース取得レベルと取得できるログの内容
  Exceptionトレースログのトレース取得レベルと取得できるログの内容を次の表に示します。
  

  表5-13　Exceptionトレースログのトレース取得レベル

  トレース取得レベル	取得できるログの内容	説明
  1	データベースとの接続と切断 ステートメントの作成とクローズ 静的SQLの実行	標準のトレース取得レベルです。コネクションとステートメントの状態と実行順序を調査したい場合に指定してください。
  2	トレース取得レベル1の内容 トランザクションのコミット，およびロールバック データベースへのアクセス要求 ResultSetクラスの処理 各オブジェクトの処理	データベースのアクセス要求の状態と実行順序を調査したい場合に指定してください。ソースとログの比較が容易になります。
  3	トレース取得レベル1および2の内容 XA要求	XA要求の状態と実行順序を調査したい場合に指定してください。
  5	トレース取得レベル1,2および3の内容 JDBCドライバの内部呼び出し	内部処理の状態と実行順序を調査したい場合に指定してください。

  　
  
• Exceptionトレースログを出力するメソッドのトレース取得レベル
  Exceptionトレースログを出力するメソッドのトレース取得レベルを次の表に示します。
  

  表5-14　Exceptionトレースログを取得するメソッドのトレース取得レベル

  クラス名	メソッド名	トレース取得レベル	備考
  CallableStatement	boolean execute()※1	2	Statementクラス，およびPreparedStatementクラスのメソッドをオーバーライドしたメソッド。
  	ResultSet executeQuery()※1	2
  	int executeUpdate()※1	2
  	boolean execute(String sql)※2	1
  	int[] executeBatch()	2
  	ResultSet executeQuery(String sql)※2	1
  	int executeUpdate(String sql)※2	1
  Connection	void close()	1	−
  	void commit()	2	−
  	Statement createStatement()※1	1	−
  	Statement createStatement(int resultSetType, int resultSetConcurrency)※2	1	−
  	DatabaseMetaData getMetaData()	2	−
  	CallableStatement prepareCall(String sql)※1	1	−
  	CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency)※2	1	−
  	PreparedStatement prepareStatement(String sql)※1	1	−
  	PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency)※2	1	−
  	void rollback()	2	−
  	void setAutoCommit(boolean autoCommit)	2	−
  DatabaseMetaData	ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable)	2	−
  	ResultSet getCatalogs()	2	−
  	ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern)	2	−
  	ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern)	2	−
  	Connection getConnection()	2	−
  	ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable)	2	−
  	ResultSet getExportedKeys(String catalog, String schema, String table)	2	−
  	ResultSet getImportedKeys(String catalog, String schema, String table)	2	−
  	ResultSet getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate)	2	−
  	ResultSet getPrimaryKeys(String catalog, String schema, String table)	2	−
  	ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern)	2	−
  	ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern)	2	−
  	ResultSet getSchemas()	2	−
  	ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern)	2	−
  	ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types)	2	−
  	ResultSet getTableTypes()	2	−
  	ResultSet getTypeInfo()	2	−
  	ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types)	2	−
  	ResultSet getVersionColumns(String catalog, String schema, String table)	2	−
  Driver	Connection connect(String url, Properties info)	1	−
  PreparedStatement	boolean execute()※1	2	−
  	ResultSet executeQuery()※1	2	−
  	int executeUpdate()※1	2	−
  	ResultSetMetaData getMetaData()	2	−
  	boolean execute(String sql)※2	1	Statementクラスのメソッドをオーバーライドしたメソッド。
  	int[] executeBatch()	2
  	ResultSet executeQuery(String sql)※2	1
  	int executeUpdate(String sql)※2	1
  ResultSet	boolean absolute(int row)	2	データベースにアクセスするときだけ取得します。
  	void afterLast()	2
  	void beforeFirst()	2
  	void close()	2	−
  	boolean first()	2	データベースにアクセスするときだけ取得します。
  	ResultSetMetaData getMetaData()	2	−
  	Statement getStatement()	2	−
  	boolean last()	2	データベースにアクセスするときだけ取得します。
  	boolean next()	2
  	boolean relative(int rows)	2
  Statement	void cancel()	2	−
  	void close()	1	−
  	boolean execute(String sql)	1	−
  	int[] executeBatch()	2	−
  	ResultSet executeQuery(String sql)	1	−
  	int executeUpdate(String sql)	1	−
  	ResultSet getResultSet()	2	−
  DataSource	Connection getConnection()※1	1	−
  	Connection getConnection(String username, String password)※2	1	−
  PooledConnection	void close()	1	−
  	Connection getConnection()	1	−
  ConnectionPoolDataSource	PooledConnection getPooledConnection()※1	1	−
  	PooledConnection getPooledConnection(String username, String password) ※2	1	−
  XAConnection	XAResource getXAResource()	1	−
  XADataSource	XAConnection getXAConnection()※1	1	−
  	XAConnection getXAConnection(String user, String password)※2	1	−
  XAResource	void commit(Xid xid, boolean onePhase)	3	−
  	void end(Xid xid, int flags)	3	−
  	void forget(Xid xid)	3	−
  	boolean isSameRM(XAResource xares)	3	−
  	int prepare(Xid xid)	3	−
  	Xid[] recover(int flag)	3	−
  	void rollback(Xid xid)	3	−
  	void start(Xid xid, int flags)	3	−

  注※1　メソッド名は，「メソッド名(1)」と出力されます。

  注※2　メソッド名は，「メソッド名(2)」と出力されます。

  
  

(b)　ファイル出力先

Exceptionトレースログを出力するファイルの出力先を設定できます。

• 設定方法
  ファイル出力先は，次の環境変数で指定します。
  

  環境変数名	説明
  DAB_FILEDIR	Exceptionトレースログの出力先のディレクトリを絶対パスで指定します。 指定を省略した場合は，次の場所にExceptionトレースログが出力されます。 Windowsの場合 <Cosminexus DABroker Library運用ディレクトリ>\spool UNIXの場合 <Cosminexus DABroker Library運用ディレクトリ>/spool ファイルの出力先として，<ファイルの出力先ディレクトリ>\<J2EEサーバ名称+MTrc.log>のバイト数が259バイトを超える値は指定しないでください。環境変数の設定値のバイト数の上限は，1,024バイトです。上限を超えた場合は，先頭から1,024バイト分だけが有効になります。 指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

(c)　ファイル出力情報量

Exceptionトレースログを出力するファイルの出力情報量を設定できます。

• 設定方法
  ファイル出力情報量は，次の環境変数で指定します。
  

  環境変数名	説明
  DAB_FILEOUTNUM	ファイル出力情報量として，メモリ内取得情報をファイルに出力する回数の上限を指定します。指定できる範囲は，1〜50です。 指定を省略した場合，または不正な値を指定した場合は，出力情報量として，5を仮定します。指定された値が1以下の場合は1，50以上の場合は50を出力情報量として仮定します。 指定した上限を超えて出力しようとすると，カレントファイルは１世代前のファイルとなり，新しくカレントファイルが作成されて，情報が出力されます。 環境変数の設定値のバイト数の上限は，10バイトです。上限を超えた場合には，先頭から10バイト分だけが有効になります。 指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

  　
  
• 情報量の上限
  一つのファイルに出力する情報量の上限（単位：行）は，次の算出式で求められます。
  

  　
  情報量の上限＝（DAB_ONMEMNUMの指定値）×（DAB_FILEOUTNUMの指定値）
  　

  なお，Exceptionトレースログを出力するためのファイルサイズの概算（単位：キロバイト）は，次の算出式で求められます。
  

  　
  出力するファイルサイズ＝2×メモリ内取得情報量（DAB_ONMEMNUMの指定値）×ファイル出力情報量（DAB_FILEOUTNUMの指定値）×2
  　

(d)　メモリ内取得情報量

Exceptionトレースログを出力するファイルのメモリ内取得情報量を設定できます。

• 設定方法
  メモリ内取得情報量は，次の環境変数で指定します。
  

  環境変数名	説明
  DAB_ONMEMNUM	メモリ内取得情報量として，メモリ内で保持する情報量の上限を指定します。指定できる範囲は500〜10,000（単位は，行※）です。 指定を省略した場合，または不正な値を指定した場合は，メモリ内取得情報量として，1,000を仮定します。指定された範囲が500以下の場合は500，10,000以上の場合は10,000をメモリ内取得情報量として仮定します。 指定した上限を超えて保持しようとすると，ラップアラウンドします。 環境変数の設定値のバイト数の上限は，10バイトです。上限を超えた場合には，先頭から10バイト分だけが有効になります。 指定値の前後にスペースがあった場合は，スペースを削除した値を指定値として扱います。

  注※　1行とは，メソッドの呼び出し情報，メソッドの戻り情報，およびException情報のそれぞれで一度に取得する情報のことです。

  
  　
  
• メモリ所要量の算出式
  Exceptionトレースログを出力するために必要となるメモリ所要量（単位：キロバイト）は，次の算出式で求められます。
  

  　
  メモリ所要量＝2×メモリ内取得情報量（DAB_ONMEMNUMの指定値）