IBM Data Server Driver for JDBC and SQLJ での問題診断

データ・サーバー接続のテスト

DB2Jcc ユーティリティーを実行して、データ・サーバーへの接続をテストします。 IBM Data Server Driver for JDBC and SQLJ タイプ 4 接続 または IBM Data Server Driver for JDBC and SQLJ タイプ 2 接続の場合は、 DB2Jcc にデータ・サーバーの URL を指定します。 DB2Jcc はデータ・サーバーへの接続、そして SQL ステートメントと DatabaseMetaData メソッドの実行を試みます。 接続またはステートメントの実行に失敗すると、DB2Jcc は失敗に関する診断情報を提供します。

JDBC トレース・データの収集

以下の手順のいずれかを使用して、トレースを開始します。

手順 1: IBM Data Server Driver for JDBC and SQLJ タイプ 4 接続 または IBM Data Server Driver for JDBC and SQLJ タイプ 2 接続 ( Db2®の場合) 推奨される方法は、 IBM Data Server Driver for JDBC and SQLJ 構成プロパティー・ファイルで db2.jcc.override.traceFile プロパティーまたは db2.jcc.override.traceDirectory プロパティーを設定することによって、トレースを開始することです。 ドライバーの開始前に db2.jcc.tracePolling および db2.jcc.tracePollingInterval プロパティーを設定すれば、ドライバーの実行中にグローバル構成トレース・プロパティーを変更することができます。

手順 3:

DataSource インターフェースを使用してデータ・ソースに接続する場合、javax.sql.DataSource.setLogWriter メソッドを呼び出して、トレースをオンにします。 この方法では、使用可能なトレース・レベルは TRACE_ALL のみです。

接続が確立された後、トレースをオフにしたりオンに戻したり、トレースの宛先を変更したり、DB2Connection.setJccLogWriter メソッドを使用してトレース・レベルを変更したりできます。 トレースをオフにするには、logWriter 値を null に設定します。

logWriter プロパティーはタイプ java.io.PrintWriter のオブジェクトです。 アプリケーションが java.io.PrintWriter オブジェクトを処理できない場合、traceFile プロパティーを使用してトレース出力の宛先を指定できます。 traceFile プロパティーを使用するには、logWriter プロパティーを null に設定し、traceFile プロパティーをドライバーがトレース・データを書き込むファイルの名前に設定します。 このファイルおよびこのファイルが置かれているディレクトリーは書き込み可能でなければなりません。 ファイルが既に存在している場合、ドライバーがこのファイルを上書きします。

String url = "jdbc:db2://sysmvs1.stl.ibm.com:5021/san_jose" +
 ":traceFile=/u/db2p/jcctrace;" +
 "traceLevel=" + com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRDA_FLOWS + ";";

手順 5: DB2TraceManager メソッドを使用します。 DB2TraceManager クラスは、すべてのタイプのログ書き込みプログラムによるトレースを中断および再開する機能を提供します。

構成プロパティーを使用してトレースを開始する例: 構成パラメーターを使用してトレース・データを収集する完全な例については、 JDBC トレースを開始するための構成プロパティーの使用例を参照してください。

トレース・サンプル・プログラム: IBM Data Server Driver for JDBC and SQLJでのトレース用プログラムの完全な例については、 IBM Data Server Driver for JDBC and SQLJでのトレース・プログラムの例を参照してください。

カスタマイズまたはバインド時の SQLJ トレース・データの収集

SQLJ のカスタマイズまたはバインド処理時に問題を診断するためにトレース・データを収集するには、db2sqljcustomize または db2sqljbind バインド・ユーティリティーの実行時に -tracelevel および -tracefile オプションを指定します。

Db2 データ・サーバーまたはデータ共用グループへの接続に関する診断データの収集

jccDump_timestamp_random-number_i.log

ファイルの最大サイズは、約 2MB です。 アプリケーションが最初のトレース・レコードを書き込むときに、ドライバーは i = 0 のファイルを作成します。 その後ドライバーは、ファイルにトレース・データを書き込みます。 ファイルのサイズが約 2MB に達すると、ドライバーはファイルの名前を変更します。 新しい名前は元の名前と同じですが、I は現在 1 になっています。 ドライバーは、アプリケーションが完了するまでこのサイクルを継続します。 ファイル内の各ダンプ項目には、タイム・スタンプ、JVM 名、スレッド ID、データ・ソース ID、および接続 ID の詳細が含まれているため、例外のソースを見つけることができます。

データ・サーバー用に収集するデータの指定: db2.jcc.diagLevelExceptionCode グローバル構成プロパティーを設定することにより、診断データを収集する SQL エラー・コードまたは SQL 警告コードを指定します。

データ共有グループのデータ収集の指定: db2.jcc.traceLevel または db2.jcc.override.traceLevel グローバル構成プロパティー、あるいは traceLevel Connection または DataSource プロパティーが TRACE_SYSPLEX (X'80000 ') に設定されている場合、 IBM Data Server Driver for JDBC and SQLJ は、サーバー・リスト、自動クライアント・リルートおよびワークロード・バランシング・プロパティー値、トランスポート・プール統計、および特殊レジスター値など、データ共有グループに関するデータを収集します。

SQLJ シリアライズド・プロファイルに関する情報のフォーマット

profp ユーティリティーは、シリアライズド・プロファイル内の各 SQLJ 文節に関する情報をフォーマットします。 profp ユーティリティーのフォーマットは次のとおりです。

エラーが発生した接続のシリアライズド・プロファイルに対して profp ユーティリティーを実行します。 例外がスローされると、Java スタック・トレースが生成されます。 例外がスタック・トレースからスローされたときに、どのシリアライズド・プロファイルが使用されていたかを判別できます。

SQLJ カスタマイズ済みシリアライズド・プロファイルに関する情報のフォーマット

db2sqljprint ユーティリティーは、 IBM Data Server Driver for JDBC and SQLJ用にカスタマイズされたシリアライズド・プロファイル内の各 SQLJ 文節に関する情報をフォーマットします。

エラーが発生した接続のカスタマイズ済みシリアライズド・プロファイルに対して db2sqljprint ユーティリティーを実行します。