IBM Data Server Driver for JDBC and SQLJ 構成プロパティ

以下の表は、構成プロパティーおよび対応する Connection または DataSource プロパティー (存在する場合) を要約しています。

以下の定義は、構成プロパティーの意味を記載しています。

db2.jcc.accountingInterval

Db2 アカウント・レコードをコミット・ポイントで作成するか、データ・ソースへの物理接続の終了時に作成するかを指定します。 db2.jcc.accountingInterval の値がCOMMITの場合、 Db2 会計記録はコミットポイントで作成されます。 このプロパティーについて、以下の例で説明します。

db2.jcc.accountingInterval=COMMIT

それ以外の場合、アカウント・レコードはデータ・ソースへの物理接続の終了時に作成されます。

db2.jcc.accountingInterval IBM タイプ2接続 Data Server Driver for JDBC and SQLJ のみに適用されます。 Db2 for z/OS。 db2.jcc.accountingInterval CICS® または 以下の接続、または Java ストアドプロシージャには適用されません。 IMS

db2.jcc.accountingInterval を上書きするには、 Connection または DataSource オブジェクトの accountingInterval プロパティを設定します。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.allowSqljDuplicateStaticQueries

SQLJアプリケーションにおける単一のSELECT文で複数のイテレータを開くことが、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続で許可されるかどうかを指定します。

このサポートを使用可能にするには、db2.jcc.allowSqljDuplicateStaticQueries を YES または true に設定します。

db2.jcc.alternateUTF8Encoding

IBM JRE バージョン 8 以上で動作する JDBC ドライバが、 UTF8 データを使用する際に、 UTF8 の代わりに UTF8J 実装を使用するかどうかを指定します。 Java 8では、 UTF8 実装ルールが厳格化され、Java 8にアップグレードすると、特定のデータで不正な入力例外が発生する可能性があります。 IBM JREで利用可能な UTF8J の実装は、Java 8の以前のバージョンと互換性があることが期待されています。 UTF8 の実装は、 IBM JRE 8以上でそのようなデータを正常に処理することができます。

0

JRE が備えている標準の UTF8 実装を UTF8 データに使用することを意味するデフォルト値。

1

IBM JREで実行している場合、 UTF8 データには UTF8J 実装を使用することを意味する値。

db2.jcc.charOutputSize

Types.CHAR として登録されている INOUT または OUT ストアード・プロシージャー・パラメーターに使用する最大バイト数を指定します。

ストアドプロシージャのINOUTおよびOUTパラメータのDESCRIBE情報は実行時に利用できないため、デフォルトでは、 IBM Data Server Driver for JDBC and SQLJ 各文字INOUTまたはOUTパラメータの最大長は32767に設定されます。 多数の Types.CHAR パラメーターを持つストアード・プロシージャーの場合、この最大設定により、必要以上に多くのストレージが割り振られる可能性があります。

ストレージをより効率的に使用するために、db2.jcc.charOutputSize には、Types.CHAR の INOUT または OUT パラメーターの想定最大長を設定してください。

db2.jcc.charOutputSize は、Types.VARCHAR または Types.LONGVARCHAR として登録されている INOUT または OUT パラメーターには影響しません。 Types.VARCHAR および Types.LONGVARCHAR パラメーターには、ドライバーはデフォルト長 32767 を使用します。

db2.jcc.charOutputSize の値を選択するときは、文字変換時に拡張される可能性があることを考慮に入れてください。 なぜなら、 IBM Data Server Driver for JDBC and SQLJ 出力パラメータ値に使用されるサーバー側の CCSID に関する情報が存在しないため、ドライバはストアドプロシージャの出力データを UTF-8 Unicode で要求します。 db2.jcc.charOutputSize の値は、パラメーター値を UTF-8 Unicode に変換した後に必要になる最大バイト数でなければなりません。 UTF-8 Unicode 文字は、最大で 3 バイトを必要とします。 (3 バイトの UTF-8 文字の例としてユーロ記号があります。) 出力データに関する情報がない場合に db2.jcc.charOutputSize の値を十分な大きさにするには、db2.jcc.charOutputSize を、最大 CHAR パラメーターに定義されている 3 倍の長さに設定してください。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.clientApplcompat or db2.jcc.override.clientApplcompat

を許可する IBM Data Server Driver for JDBC and SQLJ 指定された機能レベルの機能を使用する Db2 for z/OS 機能レベルの機能を使用できます。 この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.commandTimeout or db2.jcc.override.commandTimeout

アプリケーションが実行される最大時間を秒単位で指定します。 IBM Data Server Driver for JDBC and SQLJ SQL 操作が完了するのを待つ時間を秒単位で指定します。ドライバが SQLException をスローする前に。 この待ち時間には、トランスポートを取得し、フェイルオーバーを実行し (必要な場合)、要求を送信して応答を待機する時間が含まれます。 このパラメーターのデータ・タイプは int です。 デフォルトは 0 です。これは、タイムアウトがないことを意味します。

java.sql.Statement.setQueryTimeout メソッドが呼び出された場合、 Statement.setQueryTimeout で設定されたクエリタイムアウト値が db2.jcc.commandTimeout の値を上書きします。

db2.jcc.commandTimeout Statement、、 のメソッド、、 の実行に適用されます。 PreparedStatement CallableStatement execute executeQuery executeUpdate db2.jcc.commandTimeout executeBatch メソッドにも適用されます。プロパティ が値 INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2) を持つ場合。 queryTimeoutInterruptProcessingMode

SQLException と一緒に返される SQL エラー・コードは、データ・サーバーおよび queryTimeoutInterruptProcessingMode プロパティーの値に応じて以下のように異なります。

• IBM Data Server Driver for JDBC and SQLJ タイプ4のデータサーバーへの接続性については、 Db2 for z/OS、 queryTimeoutInterruptProcessingMode の値は常に INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2) となります。
  • Sysplex ワークロード・バランシングが有効になっている場合、SQL エラー・コード -30108 が返されます。
  • 自動クライアント・リルート処理が有効で、Sysplex ワークロード・バランシングが無効の場合、SQL エラー・コード -4498 が返されます。
  • Sysplex ワークロード・バランシングも自動クライアント・リルート処理も無効の場合は、 SQL エラー・コード -4499 が返されます。

  db2.jcc.commandTimeout の値を超えると、自動的なクライアントの再ルーティング処理は開始されません。

• その他のデータ・サーバーへの接続の場合、以下のようになります。
  • queryTimeoutInterruptProcessingMode 値が INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL (1) の場合、-952 が返されます。
  • queryTimeoutInterruptProcessingMode の値が INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2) の場合は、次のようになります。
    • ワークロードバランシングが有効になっている場合、 Db2 ワークロードバランシングが有効になっている場合、SQLエラー-30108が返されます。
    • 自動クライアント再ルーティング処理が有効で、 Db2 ワークロードが無効になっている場合、SQLエラー-4498が返されます。
    • 自動クライアント再ルーティング処理も Db2 有効になっていない場合、SQLエラー-4498が返されます。

構成プロパティー db2.jcc.enableInetAddressGetHostName が true に設定されている場合、以下の状況が発生する可能性があります。

• 実際の待ち時間は、 db2.jcc.commandTimeout の値を超える場合があります。 この状況は、IP アドレスをホスト名に解決するためにドライバーが複数の DNS ルックアップ操作を行う必要がある場合に生じ得ます。 待ち時間が db2.jcc.commandTimeout の値を超える量は、DNSルックアップ操作の回数と、各DNSルックアップ操作に要する時間に依存します。
• DNS ルックアップ操作に余分な時間が必要になると、db2.jcc.enableInetAddressGetHostName が false に設定されている場合よりも多くのタイムアウト条件が発生する可能性があります。

db2.jcc.currentPackageSet or db2.jcc.override.currentPackageSet

JDBC および SQLJ パッケージの検索に使用するコレクション ID を指定します。 このプロパティーのデータ・タイプは String です。 デフォルトは NULLID です。 このプロパティー値を設定すると、jdbcCollection の値をオーバーライドできます。

複数のインスタンスを IBM Data Server Driver for JDBC and SQLJDB2Binder ユーティリティを複数回実行することで、データベースサーバーにインストールすることができます。 DB2binder ユーティリティには、インスタンスごとにコレクションIDを指定できる-collectionオプションが含まれています。 IBM Data Server Driver for JDBC and SQLJ インスタンスごとにコレクションIDを指定することができます。 接続用のインスタンスを選択するには、 IBM Data Server Driver for JDBC and SQLJ 接続用にインスタンスを選択するには、インスタンスのいずれかのコレクションIDに一致する currentPackageSet 値を指定します。 IBM Data Server Driver for JDBC and SQLJ インスタンスのコレクションIDに一致する

currentPackagePath および currentPackageSet プロパティーの優先順位規則は、CURRENT PACKAGESET および CURRENT PACKAGE PATH 特殊レジスターの優先順位規則に従います。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.currentSchema or db2.jcc.override.currentSchema

動的に準備される SQL ステートメントで非修飾データベース・オブジェクトを修飾するために使用されるデフォルトのスキーマ名を指定します。 このプロパティーの値は、データベース・サーバーでの CURRENT SCHEMA 特殊レジスター内の値を設定します。 スキーマ名は大文字小文字の区別があり、大文字で指定する必要があります。

この構成プロパティは Db2 for z/OS または Db2 on Linux、UNIX、および Windows システムのみに適用されます。

db2.jcc.currentSQLID or db2.jcc.override.currentSQLID

これらのプロパティーは、以下のステートメントを指定します。

• 動的に作成された CREATE、GRANT、 および REVOKE SQL ステートメントに対する許可検査で使用される許可 ID。
• 動的に発行された CREATE ステートメントによって作成される、 表スペース、データベース、ストレージ・グループ、またはシノニムの所有者。
• 動的 SQL ステートメントで指定される、すべての表、ビュー、別名、および索引名の暗黙修飾子。

currentSQLID サーバー上のCURRENT SQLID 特殊レジスタの値を設定します。 Db2 for z/OS サーバー上の currentSQLID プロパティーが設定されていない場合、 デフォルトのスキーマ名は、CURRENT SQLID 特殊レジスター内の値です。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.customerId

IBM Data Server Driver for JDBC and SQLJ トレース出力とともに Elasticsearch などの検索および分析製品に送信される顧客 ID 値を指定します。 db2.jcc.customerId のデフォルト値は cid です。

db2.jcc.decimalRoundingMode or db2.jcc.override.decimalRoundingMode

Db2 for z/OS または Db2 on Linux、UNIX、および Windows システムデータ サーバー上の 10 進浮動小数点変数または DECFLOAT 列に割り当てるための丸めモードを指定します。

プロパティーに指定可能な値を以下に記載します。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_DOWN (1)

0 の方向に丸めます (切り捨て)。 破棄された数字は無視されます。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_CEILING (2)

正の無限大方向に丸めます。 破棄される数字がすべてゼロであるか、または符号が負の場合、破棄される数字の除去を除いて結果は未変更のままになります。 それ以外の場合、結果の係数は 1 だけ増やされます。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_HALF_EVEN (3)

値を最も近い値に丸めます。複数の値が等距離にある場合は、最後の数字が偶数になるように値を丸めます。 破棄される数字が、左側にある次の桁の 1 の値の半分 (0.5) より大きい場合、結果の係数は 1 だけ増分されます。 半分より小さい場合、結果の係数は調整されません (つまり、廃棄された数字は無視されます)。 それ以外の場合、結果の係数の右端の数字が偶数であれば、その係数は変更されませんが、右端の数字が奇数であれば、その桁が偶数になるように 1 だけ増大 (切り上げ) します。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_HALF_UP (4)

値を最も近い値に丸めます。複数の値が等距離にある場合は、0 の反対方向に値を丸めます。 破棄される数字が、左側にある次の桁の 1 の値の半分 (0.5) 以上である場合、結果の係数は 1 だけ増分されます。 それ以外の場合、廃棄された数字は無視されます。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_FLOOR (6)

負の無限大方向に丸めます。 破棄される数字がすべてゼロであるか、または符号が正の場合、破棄される数字の除去を除いて、結果は未変更のままになります。 それ以外の場合、符号は負で、結果の係数は 1 だけ増やされます。

com.ibm.db2.jcc.DB2BaseDataSource.ROUND_UNSET (-2147483647)

丸めモードは明示的に設定されませんでした。 The IBM Data Server Driver for JDBC and SQLJ データベースサーバーの丸めモードを設定するのに decimalRoundingMode を使用しません。 丸めモードは ROUND_HALF_EVEN です。

db2.jcc.decimalRoundingMode または db2.jcc.override.decimalRoundingMode の値を明示的に設定すると、その値がデータサーバー上のCURRENT DECFLOAT ROUNDING MODE特殊レジスタ値を更新します。 Db2 for z/OS データサーバー上の

db2.jcc.decimalRoundingMode Linux または の値を明示的に設定した場合、その値は db2.jcc.override.decimalRoundingMode 、UNIX、Windowsシステムデータサーバー上の の Db2 CURRENT DECFLOAT ROUNDING MODE特殊レジスタ値を更新しません。 db2.jcc.decimalRoundingMode または db2.jcc.override.decimalRoundingMode に設定した値が CURRENT DECFLOAT ROUNDING MODE 特殊レジスターの値と異なる場合は、Exception がスローされます。 データ・サーバーの値を変更するためには、その値を decflt_rounding データベース構成パラメーターで設定する必要があります。

decimalRoundingMode は、10 進値の代入には影響を与えません。 この関数は、 IBM Data Server Driver for JDBC and SQLJ 小数点以下の値は常に切り捨てられます。

db2.jcc.defaultSQLState

IBM Data Server Driver for JDBC and SQLJ クライアントに返すSQLSTATE値を指定します。 SQLException または SQLWarning SQLSTATE 値が null であるオブジェクト。 この構成プロパティーは以下の方法で指定できます。

db2.jcc.defaultSQLState

db2.jcc.defaultSQLState が値なしで指定された場合、 IBM Data Server Driver for JDBC and SQLJ 「FFFFF」が返されます。

db2.jcc.defaultSQLState=xxxxx

フォーマット内の xxxxxx という値は、 IBM Data Server Driver for JDBC and SQLJ SQLSTATE値がnullの場合に返される値です。 xxxxx が 5 バイトより長い場合、ドライバーは値を切り捨てて、5 バイトにします。 xxxxx が 5 バイトより短い場合、ドライバーは xxxxx の右方にブランクを埋め込みます。

db2.jcc.defaultSQLState が指定されていない場合、 IBM Data Server Driver for JDBC and SQLJ SQLSTATE値としてnullが返されます。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.diagLevelExceptionCode

診断情報が収集される 1 つ以上の SQL エラー・コードまたは SQL 警告コードを指定します。

db2.jcc.diagLevelExceptionCode の値が指定されていない場合、診断データは収集されません。

db2.jcc.diagLevelExceptionCode が -1 に設定されている場合、すべてのSQLエラーコードの診断情報が収集されます。

SQLエラーコードは、符号なし、マイナス（-）符号を前置、または文字 n を後置して指定することができます。 SQLの警告コードには、プラス（+）記号を前置することも、アルファベット文字 p を後置することもできます。

複数のSQLエラーコードまたはSQL警告コードが指定されている場合、それらのコードはカンマで区切らなければなりません。

次に例を示します。

SQL エラーコード -204 の診断情報を収集するには、以下の値のいずれかを指定します

• db2.jcc.diagLevelExceptionCode=204
• db2.jcc.diagLevelExceptionCode=-204
• db2.jcc.diagLevelExceptionCode=204n

SQL 警告コード +222 の診断情報を収集するには、以下の値のいずれかを指定します

• db2.jcc.diagLevelExceptionCode=+222
• db2.jcc.diagLevelExceptionCode=222p

SQLエラーコード-204、-30108、-4499の診断情報の収集を指定する例をいくつか挙げます

• db2.jcc.diagLevelExceptionCode=-204,-30108,-4499
• db2.jcc.diagLevelExceptionCode=204,30108n,4499
• db2.jcc.diagLevelExceptionCode=204n,30108,4499n

SQL エラーコード -30108 および SQL 警告コード +100 および +222 の診断情報の収集を指定する例を以下に示します

• db2.jcc.diagLevelExceptionCode=+100,-30108,222p
• db2.jcc.diagLevelExceptionCode=100p,30108,+222

診断データは、構成プロパティー db2.jcc.outputDirectory によって指定されたディレクトリー内のファイルに書き込まれます。 ファイルの形式は次のとおりです。

jccDump_timestamp_random-number_i.log

• timestamp は、データが書き込まれるときのタイム・スタンプです。
• random-number は、ランダムに生成された正の整数です。
• i は 0 または 1 です。

db2.jcc.disableClientInputDataConversion または db2.jcc.override.disableClientInputDataConversion

IBM Data Server Driver for JDBC and SQLJ 特定のタイプの数値クライアント データを Db2 on Linux、UNIX、および Windows システムデータ サーバーに送信する前に変換するかどうかを指定します。

影響を受けるソースとターゲットのデータ型は、 NUMBER データ型にリストされている。 Javaデータ型とデータ・サーバー・データ型のマッピングについては、 Javaアプリケーションでデータベース・データ型にマッピングされるデータ型を参照してください。

データサーバー上の DB2_COMPATIBILITY_VECTOR レジストリ変数がX'10'に設定されている場合は、変換を無効にする必要があるかもしれません。

可能な値は以下のとおりです。

0 または指定なし

クライアントデータを IBM Data Server Driver for JDBC and SQLJ クライアントデータをターゲットデータ型に変換することを指定します。 0 がデフォルト値です。

1

クライアントデータをターゲットデータ型に変換しないことを指定します。 IBM Data Server Driver for JDBC and SQLJ クライアントデータをターゲットデータ型に変換しないことを指定します。

2

クライアントデータを IBM Data Server Driver for JDBC and SQLJ クライアントデータをターゲットデータ型に変換することを指定します。

db2.jcc.disableSQLJProfileCaching

アプリケーションを実行している JVM がリセットされるときに、直列化されたプロファイルがキャッシュされるかどうかを指定します。 db2.jcc.disableSQLJProfileCaching リセット可能な JVM で実行されるアプリケーション（、、または Java ストアドプロシージャ環境で実行されるアプリケーション）のみに適用され CICS IMS、 タイプ 2 接続 IBM Data Server Driver for JDBC and SQLJ を使用する Db2 for z/OS。 プロパティーに指定可能な値を以下に例示します。

YES

JVM がリセットされるときに、直列化された SQLJ プロファイルの新規バージョンがロードされるので、その直列化された SQLJ プロファイルは、JVM がリセットされる度にキャッシュされる訳ではありません。 アプリケーションが開発中のときにこのオプションを使用すると、アプリケーションおよび直列化されたプロファイルの新規バージョンが頻繁に作成されます。

NO

JVM がリセットされるときに、直列化された SQLJ プロファイルをキャッシュします。 デフォルトはNOです。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.disableTimezone

タイム・スタンプ値のタイム・ゾーン部分がデータ・サーバーに送信されないかどうかを指定します。 以下の値は、プロパティーの指定可能な値を示しています。

true or yes

データ・サーバーが TIMESTAMP WITH TIME ZONE データ・タイプをサポートしている場合でも、タイム・スタンプのタイム・ゾーン部分がデータ・サーバーに送信されないことを示します。

Any other value

タイム・スタンプのタイム・ゾーンの部分をデータ・サーバーに送信することを指定するデフォルト値。

db2.jcc.driverLocationFile

が診断やシステム監視に使用できるドライバ使用データを書き込むファイルへのファイルパスを指定します。 IBM Data Server Driver for JDBC and SQLJ がドライバの使用状況データを書き込むファイルのパスを指定します。

ドライバーは以下の情報をファイルに書き込む。 カッコ内は見出し。

ユーザー名 (USER)

JDBC ドライバのインスタンスが実行されているユーザー名。

Process ID (PID)

JDBC ドライバを使用しているプロセス。

重要： JDK 1.8 で実行される JDBC アプリケーションでは、 JDBC ドライバが PID を取得できない場合があります。 JDBC ドライバがPIDを取得できない場合、ドライバ使用データファイルのPID値に -1 の値を書き込む。

Timestamp (Date)

トラッキングのため、各エントリーの時間。

Driver path (Path)

JDBC ドライバの現在のパス。

db2.jcc.driverLocationFile が既に存在するファイル・パスに設定されると、 JDBC ドライバは既存のファイルにデータを追加する。 db2.jcc.driverLocationFile にまだ存在しないファイルパスが設定された場合、 JDBC ドライバは指定されたファイルパスのファイルを作成し、そこにデータを書き込む。

例例 IBM Data Server Driver for JDBC and SQLJ グローバル・コンフィギュレーション・ファイルでは、 db2.jcc.driverLocationFile は次のように設定されている：

db2.jcc.driverLocationFile=/path/to/log/db2_driver_log.txt

JDBC ドライバが指定されたファイルに書き込むデータは、このデータに似ている：

User: myname PID: 24832 Date: 2025-05-04T12:42:56.862480400 Path: Users/myname/Downloads/db2jcc4.jar
User: myname PID: 20280 Date: 2025-05-04T12:42:57.102025300 Path: Users/myname/Downloads/db2jcc4.jar
User: myname PID: 41916 Date: 2025-05-04T12:43:11.080369200 Path: Users/myname/Downloads/db2jcc4.jar
User: myname PID: 41924 Date: 2025-05-04T12:43:45.256655700 Path: Users/myname/Downloads/db2jcc4.jar

db2.jcc.dumpPool

サマリー統計に加えて、書き込まれるグローバル・トランスポート・プール・イベントの統計のタイプを指定します。 グローバル・トランスポート・プールは、接続コンセントレーターと Sysplex ワークロード・バランシングで使用されます。

どの統計が書き込まれるよりも前に、db2.jcc.dumpPoolStatisticsOnSchedule および db2.jcc.dumpPoolStatisticsOnScheduleFile も統計の書き込み用に設定する必要があります。

以下のリストは、db2.jcc.dumpPool プロパティーに 1 つ以上指定できる統計のタイプを例示しています。

• DUMP_REMOVE_OBJECT (16 進数: X'01 '、10 進数: 1)
• DUMP_GET_OBJECT (16 進数: X'02 '、10 進数: 2)
• DUMP_WAIT_OBJECT (16 進数: X'04 '、10 進数: 4)
• DUMP_SET_AVAILABLE_OBJECT (16 進数: X'08 '、10 進数: 8)
• DUMP_CREATE_OBJECT (16 進数: X'10 '、10 進数: 16)
• DUMP_SYSPLEX_MSG (16 進数: X'20 '、10 進数: 32)
• DUMP_POOL_ERROR (16 進数: X'80 '、10 進数: 128)

複数のイベントのタイプをトレースするには、トレースしたいイベントのタイプの値を加算します。 例えば、DUMP_GET_OBJECT イベントと DUMP_CREATE_OBJECT イベントをトレースするとします。 これらの値に相当する数値は 2 と 16 なので、db2.jcc.dumpPool 値には 18 を指定します。

デフォルトは 0 です。これは、グローバル・トランスポート・プールのサマリー統計だけが書き込まれることを意味します。

この構成プロパティは、 Db2 for z/OS または IBM Informix。

db2.jcc.dumpPoolStatisticsOnSchedule

グローバル・トランスポート・プールの統計が、db2.jcc.dumpPoolStatisticsOnScheduleFile で指定されたファイルに書き込まれる頻度を秒単位で指定します。 グローバル・トランスポート・オブジェクト・プールは、接続コンセントレーターと Sysplex ワークロード・バランシングで使用されます。

デフォルトは -1 です。-1 は、グローバル・トランスポート・プール統計が書き込まれないことを意味します。

この構成プロパティは、 Db2 for z/OS または IBM Informix。

db2.jcc.dumpPoolStatisticsOnScheduleFile

グローバル・トランスポート・プールの統計を書き込むファイルの名前を指定します。 グローバル・トランスポート・プールは、接続コンセントレーターと Sysplex ワークロード・バランシングで使用されます。

db2.jcc.dumpPoolStatisticsOnScheduleFile 構成プロパティーを指定しないと、グローバル・トランスポート・プールの統計は書き込まれません。

この構成プロパティは、 Db2 for z/OS または IBM Informix。

db2.jcc.enableInetAddressGetHostName

IBM Data Server Driver for JDBC and SQLJ が InetAddress.getHostName そして InetAddress.getCanonicalHostName IP アドレスのホスト名を決定する方法。 db2.jcc.enableInetAddressGetHostName IBM タイプ4接続 Data Server Driver for JDBC and SQLJ のみに適用されます。 このプロパティーに指定できる値として、以下の値があります。

はい

このプログラムは、 IBM Data Server Driver for JDBC and SQLJInetAddress.getHostName と InetAddress.getCanonicalHostName の2つの方法を使用して、IPアドレスに対応するホスト名を決定します。

true を指定すると、DNS ルックアップ操作のために追加の時間が必要になるので、アプリケーションの実行時間が長くなる可能性があります。

いいえ

その IBM Data Server Driver for JDBC and SQLJInetAddress.getHostAddress メソッドを使用してIPアドレスを返します。 返された IP アドレスは、ホスト名の代わりに使用されます。

3.65 および 4.15 以降のバージョンでは、 IBM Data Server Driver for JDBC and SQLJ、デフォルトは false です。 バージョン 3.64 および 4.14 以前の場合、デフォルトは true です。

db2.jcc.enableDualTransportUsingDifferentProcess or db2.jcc.override.enableDualTransportUsingDifferentProcess

XA トランザクションがデュアルトランスポートまたはマルチトランスポートトランザクションモデルで使用するプロトコルを指定します。 IBM Data Server Driver for JDBC and SQLJ デュアルトランスポートまたはマルチトランスポートトランザクションモデルで使用する 可能値は次のとおりです。

0 または指定なし

XA トランザクションが IBM Data Server Driver for JDBC and SQLJ Javaランタイム環境がxa_endコール後にXidオブジェクトを解放しないプロトコルを使用することを指定します。 オブジェクトは、xa_commit または xa_rollback 呼び出しが発行されるまで使用可能です。 この値がデフォルトです。

1

XA トランザクションが IBM Data Server Driver for JDBC and SQLJ Javaランタイム環境がxa_endコール後にXidオブジェクトを解放するプロトコルを使用することを指定します。 アプリケーションでは、トランザクションマネージャに対してこの値を設定する必要があるかもしれません。 IBM Data Server Driver for JDBC and SQLJ xa_startおよびxa_end呼び出しを発行するが、xa_prepare、xa_commit、またはxa_rollback呼び出しを発行するには他の手段を使用するトランザクションマネージャーに対して、この値を設定する必要があるかもしれません。 このようなトランザクション・マネージャーの例としては、IBM MQ があります。

プロパティ値が1の場合の動作は、 xaNetworkOptimization プロパティと enableSysplexWLB プロパティが false に設定されている場合のみ有効です。

2

XA トランザクションが IBM Data Server Driver for JDBC and SQLJ Javaランタイム環境がxa_endコール後にXidオブジェクトを解放しないプロトコルを使用することを指定します。 オブジェクトは、xa_commit または xa_rollback 呼び出しが発行されるまで使用可能です。 この値がデフォルトです。

db2.jcc.override.enableMultiRowInsertSupport

指定する。 IBM Data Server Driver for JDBC and SQLJ バッチ処理のINSERTまたはMERGE操作で複数行INSERTを使用するかどうかを指定します。対象のデータサーバーが Db2 for z/OS 複数行INSERTをサポートするサーバーである バッチ操作はパラメーター・マーカーを持つ PreparedStatement 呼び出し である必要があります。 デフォルトは true です。

INSERT FROM SELECT ステートメントがバッチで実行される場合は、db2.jcc.override.enableMultiRowInsertSupport は false に設定される必要があります。 そうしないと、ドライバーは BatchUpdateException をスローします。

可能な値は以下のとおりです。

true

バッチ処理のINSERTまたはMERGE操作で複数行INSERTを使用する際のデフォルト値を指定します。 IBM Data Server Driver for JDBC and SQLJ バッチ処理のINSERTまたはMERGE操作で複数行INSERTを使用する場合のデフォルト値を指定します。対象のデータサーバーが Db2 for z/OS 複数行INSERTをサポートするサーバーである

false

指定したデータベースが、 IBM Data Server Driver for JDBC and SQLJ バッチ処理のINSERTまたはMERGE操作で複数行INSERTを使用しないことを指定します。対象のデータサーバーが Db2 for z/OS 複数行INSERTをサポートするサーバーである

db2.jcc.enableRemoteLogging

IBM Data Server Driver for JDBC and SQLJ トレース出力を Elasticsearch または同等の検索および分析製品に送信するかどうかを指定します。

可能な値は以下のとおりです。

true

IBM Data Server Driver for JDBC and SQLJ トレース出力が Elasticsearch などの検索および分析製品に送信されることを指定します。 製品は、トレース出力を受信し、処理するように構成されている必要があります。

false

IBM Data Server Driver for JDBC and SQLJ トレース出力は、検索および分析製品ではなく、ドライバプロパティで指定されたローカルファイルに送信されることを指定します。 false がデフォルトです。

db2.jcc.enableSeamlessFailoverErrorCodes or db2.jcc.override.enableSeamlessFailoverErrorCodes

IBM Data Server Driver for JDBC and SQLJ -4498、-30108、-20542 などの非シームレスエラーコードを、エラーコード -4499 の通信エラーにマッピングするかどうかを指定します。 このプロパティーのデータ・タイプはブール値です。

可能な値は以下のとおりです。

true

The IBM Data Server Driver for JDBC and SQLJ シームレスエラーを通信エラーコード -4499 にマッピングしません。 アプリケーションは、発生したエラーの種類に応じて、異なるエラーコードを受け取ります。

false

アプリケーション実行中に非シームレスエラーが発生した場合、ドライバは既存の接続をすべて切断し、アプリケーションにエラー-4499を返します。

db2.jcc.enableSeamlessFailoverErrorCodes db2.jcc.override.enableSeamlessFailoverErrorCodes は、 タイプ4の接続 IBM Data Server Driver for JDBC and SQLJ に適用され、 Db2 for z/OS Linux、UNIX、およびWindowsシステム上の Db2 に適用されます。

db2.jcc.enableSeamlessFailoverErrorCodes または db2.jcc.override.enableSeamlessFailoverErrorCodes のデフォルトは、 false です。 Db2 for z/OS。 デフォルトは trueLinux、UNIX、および Windows システム上の Db2 への接続用。

db2.jcc.enableSysplexWLB or db2.jcc.override.enableSysplexWLB

のsysplexワークロード分散機能が有効になっているかどうかを示します。 IBM Data Server Driver for JDBC and SQLJ 有効になっているかどうかを示します。

可能な値は以下のとおりです。

true

のsysplexワークロード分散機能が有効になっていることを指定します。 IBM Data Server Driver for JDBC and SQLJ 有効化されていることを指定します。

false

のsysplexワークロード分散機能が無効であることを指定します。 IBM Data Server Driver for JDBC and SQLJ 無効であることを指定します。 false がデフォルトです。

Linux、UNIX、Windowsシステム上の Db2 への接続については、 db2.jcc.enableSysplexWLB または db2.jcc.override.enableSysplexWLB は、サーバーが pureScale® 環境にある場合にのみ、 true の値を持つことができます。 サポートされている他のデータベース製品については、サーバーの Sysplex ワークロード・バランシングが有効になっている場合にのみ、db2.jcc.enableSysplexWLB または db2.jcc.override.enableSysplexWLB の値を true にすることができます。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。

db2.jcc.enableT2zosLBF or db2.jcc.override.enableT2zosLBF

ローカルデータサーバー上のテーブルからデータを取得するために、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用する接続で、限定ブロックフェッチを使用できるかどうかを指定します。 Db2 for z/OS データサーバー上のテーブルからデータを取得する際に使用できます。 可能な値は以下のとおりです。

0 または指定なし

この値がデフォルトです。

• バージョン10の変換モードでデータサーバーに接続する場合、 Db2 for z/OS バージョン10の変換モードのデータサーバーへの接続の場合、 IBM Data Server Driver for JDBC and SQLJ タイプ2の接続を使用するローカルテーブルからデータを取得する際に、限定ブロックフェッチを使用しないことを指定します。
• Db2 for z/OS バージョン10の新機能モード以降のデータサーバーへの接続では、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用するローカルテーブルからデータを取得する際に、制限付きブロックフェッチを使用できることを指定します。

1

IBM Data Server Driver for JDBC and SQLJ タイプ2の接続で実行されているアプリケーションがローカルテーブルからデータを取得する際に、限定的ブロックフェッチを使用できることを指定します。

このプロパティを1に設定した場合、 IBM Db2 Analytics Accelerator for z/OS カーソル再利用時にオンにする必要がある場合、構成プロパティ db2.jcc.enableT2zosLBFSwitchWithIDAA を1に設定する必要があります。

2

IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用するローカルテーブルからデータを取得する際に、限定ブロックフェッチを使用しないことを指定します。

db2.jcc.enableT2zosLBF db2.jcc.override.enableT2zosLBF は、 Db2 for z/OS バージョン10の新機能モード以降のデータサーバーに適用されます。 これらのプロパティーは、ストアード・プロシージャーの結果セットの取得には適用されません。

db2.jcc.enableT2zosLBFSPResultSets or db2.jcc.override.enableT2zosLBFSPResultSets

ローカルデータサーバー上のストアドプロシージャの結果セットからデータを取得するために、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用する接続で、限定ブロックフェッチを使用するかどうかを指定します。 Db2 for z/OS データサーバーから 可能な値は以下のとおりです。

0 or 1

IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用してストアドプロシージャの結果セットからデータを取得する際に、制限付きブロックフェッチを使用するデフォルト値を指定します。

2

IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用して、ストアドプロシージャの結果セットからデータを取得する際に、限定ブロックフェッチを使用しないことを指定します。

db2.jcc.enableT2zosLBFSPResultSets db2.jcc.override.enableT2zosLBFSPResultSets は、 Db2 for z/OS バージョン10の新機能モード以降のデータサーバーに適用されます。

db2.jcc.enableT2zosLBFSwitchWithIDAA

IBM Data Server Driver for JDBC and SQLJ タイプ2の接続を使用するアプリケーションが、データサーバー上で実行するために、制限付きブロックフェッチを使用できるタイミングを指定します。 IBM Db2 Analytics Accelerator for z/OS。 ドライバーは、db2.jcc.enableT2zosLBF が 1 に設定されている場合にのみ、このプロパティーを使用します。 可能な値は以下のとおりです。

0 または指定なし

この値がデフォルトです。

が利用できない場合または停止している場合に、 IBM Db2 Analytics Accelerator for z/OS 利用できない場合や停止している場合、 Db2 for z/OS Javaアプリケーションがローカルカーソルを使用してデータを取得する際に、限定的なブロックフェッチを使用できることを指定します。

1

指定した IBM Db2 Analytics Accelerator for z/OS アプリケーションが実行されている際にオンまたはオフに切り替わる可能性があることを指定します。 IBM Data Server Driver for JDBC and SQLJ。 IBM Db2 Analytics Accelerator for z/OS アクティブになると、リモートカーソルが有効になり、制限付きブロックフェッチが無効になります。

db2.jcc.encryptionAlgorithm or db2.jcc.override.encryptionAlgorithm

56ビットDES（脆弱）暗号化または256ビットAES（強力）暗号化を使用するかどうかを指定します。 IBM Data Server Driver for JDBC and SQLJ 56ビットDES（脆弱）暗号化または256ビットAES（強力）暗号化を使用するかどうかを指定します。

db2.jcc.encryptionAlgorithm または db2.jcc.override.encryptionAlgorithm は、プロパティー db2.jcc.securityMechanism またはプロパティー securityMechanism が 7 または 9 に設定されている場合にのみ指定できます。

これらのプロパティーに指定できる値として、以下の値があります。

1

このドライバーは、56 ビット DES 暗号化を使用します。

2

データベース・サーバーが 256 ビット AES 暗号化をサポートしている場合、ドライバーはこの暗号化を使用します。 256ビットAES暗号化は、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみでご利用いただけます。

AES 暗号化の場合、JCE 用の無制限ポリシー・ファイルが必要です。 このファイルは以下のロケーションで入手可能です。

https://www.ibm.com/marketing/iwm/iwm/web/preLogin.do?source=jcesdk

4.33 バージョンから、 IBM Data Server Driver for JDBC and SQLJ、デフォルトの暗号化アルゴリズムは256ビットAES暗号化（2）となります。

バージョン 4.33 より前の IBM Data Server Driver for JDBC and SQLJ、デフォルトの暗号化アルゴリズムは56ビットDES暗号化（1）です。

db2.jcc.encryptionAlgorithm は、db2.jcc.securityMechanism、db2.jcc.override.securityMechanism、または securityMechanism 値が、暗号化されたパスワード・セキュリティーまたは暗号化されたユーザー ID およびパスワード・セキュリティーに対して設定されている場合のみ指定できます。

db2.jcc.extendedTableInfo

拡張表タイプについての情報が、 DatabaseMetaData.getTables メソッド呼び出しから返されるかどうかを指定します。 現時点では、ACCEL-ONLY TABLE という拡張表タイプが 1 つ存在します。

0

DatabaseMetaData.getTables メソッドによって返される結果セットには、拡張表タイプの列は含まれていません。

拡張表タイプの行は、「TABLE」が types パラメーター値で明示的に指定されている場合にのみ、返されます。 この場合、拡張表タイプは結果セットの TABLE_TYPE 列に TABLE としてリストされます。

1

DatabaseMetaData.getTables メソッドによって返される結果セットには、拡張表タイプの行および列が含まれています。 個別には以下のようになります。

• 結果セットには、DatabaseMetaData.getTables からの結果セットに常に返される列の後に、以下の特別な列が含まれます。

  表 2. 余分な列が返された DatabaseMetaData.getTables

  列名	データ・タイプ	説明
  TEMPORAL_TABLE_TYPE	ストリング	テンポラル表のタイプが含まれます。 テンポラル表に指定可能な値を以下に示します。 SYSTEM システム期間テンポラル表。 APPLICATION アプリケーション期間テンポラル表。 BITEMPORAL バイテンポラル表。 Empty string テンポラル表ではありません。 この行は、バージョン10以降への接続に対して返されます。 Db2 for z/OS バージョン10以降の接続に対して返されます。
  IS_ACCELERATED	ストリング	表が加速表であるかどうかを示します。 可能な値は YES または NO です。 この行は、バージョン10以降への接続に対して返されます。 Db2 for z/OS バージョン10以降の接続に対して返されます。
  ACCEL_ARCHIVE_STATUS	ストリング	アクセラレーター・データベースの表のアーカイブ状況が含まれます。 SYSACCEL.SYSACCELERATEDTABLES テーブルの ARCHIVE列の説明を参照し、可能な値とその意味を確認してください。 この行は、バージョン10以降への接続に対して返されます。 Db2 for z/OS バージョン10以降の接続に対して返されます。
  IS_ARCHIVE_ENABLED	ストリング	表がアーカイブ使用可能表であるかどうかを示します。 可能な値は YES または NO です。 この行は、バージョン11以降への接続に対して返されます。 Db2 for z/OS バージョン11以降の接続に対して返されます。

• 拡張表タイプの行は、以下の環境で返されます。
  • すべての表タイプが、types パラメーター値に NULL を指定することにより、暗黙的に要求される。
  • 拡張表タイプ名が、types パラメーター値に明示的に指定される。

    この場合、拡張表タイプは、結果セットの TABLE_TYPE 列にその拡張表タイプ名でリストされます。

db2.jcc.indexName

Elasticsearch などの検索および分析製品で IBM Data Server Driver for JDBC and SQLJ トレース出力が保管される索引の名前を指定します。 db2.jcc.indexName のデフォルト値は jcc です。

db2.jcc.instanceId

Elasticsearch などの検索分析製品の、インスタンス構成名の名前を指定します。 この名前は、 IBM Data Server Driver for JDBC and SQLJ 製品に送信されるトレース出力に使用される db2.jcc.instanceId のデフォルト値は iid です。

db2.jcc.jmxEnabled

インスタンスに対して Java Management Extensions (JMX) が有効になっているかどうかを指定します。 IBM Data Server Driver for JDBC and SQLJ インスタンスに対して有効であるかどうかを指定します。 アプリケーションがリモート・トレース・コントローラーを使用できるようにするには、その前に JMX を使用可能にする必要があります。

このプロパティーに指定できる値として、以下の値があります。

true or yes

JMX が使用可能にされることを示します。

その他の値

JMX が使用不可に設定されることを示すデフォルト値を指定します。

db2.jcc.keyword

Elasticsearch などの検索および分析製品に送信される IBM Data Server Driver for JDBC and SQLJ トレース出力内のデータのタイプを識別するキーワード値を指定します。 db2.jcc.keyword のデフォルト値は debug です。

db2.jcc.lobOutputSize

ドライバがLOBのサイズを決定できない場合に、 IBM Data Server Driver for JDBC and SQLJ ドライバがそれらのLOBのサイズを決定できない場合に、出力LOB値に割り当てる必要がある この状態は、LOB ストアード・プロシージャーの出力パラメーターに関して発生します。 db2.jcc.lobOutputSize IBM タイプ2接続 Data Server Driver for JDBC and SQLJ のみに適用されます。 Db2 for z/OS。

db2.jcc.lobOutputSize のデフォルト値は 1048576 です。 ストレージの制限があるシステムおよび LOB がより小さいシステムの場合、db2.jcc.lobOutputSize 値をより低い数値に設定します。

例えば、出力 LOB サイズが最大で 64000 であることがわかっている場合、db2.jcc.lobOutputSize は 64000 に設定します。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.maxConnCachedParamBufferSize

PreparedStatement オブジェクトの入力パラメーター値のキャッシングに使用される内部バッファーの最大サイズを指定します。 バッファは、ドライバのJavaコード側から渡されたネイティブコード側の値をキャッシュします。 IBM Data Server Driver for JDBC and SQLJ タイプ2の接続用です Db2 for z/OS。 すべての PreparedStatement オブジェクトは、Connection にこのバッファーを使用します。 デフォルトは 1048576 (1 MB) です。 ほとんどのユーザーには、このデフォルトが適切なはずです。 ドライバー・インスタンスで実行する多くのアプリケーションに、多数の入力パラメーターまたは大きい入力パラメーターを持つ PreparedStatement オブジェクトがある場合には、db2.jcc.maxConnCachedParamBufferSize をこれよりも大きい値に設定します。 db2.jcc.maxConnCachedParamBufferSize は、Connection のすべての入力パラメーター・データの最大サイズより大きくする必要があります。 ただし、db2.jcc.maxConnCachedParamBufferSize 値を設定するときには、接続の総数および使用可能な最大メモリー量も考慮する必要があります。

バッファーは、Connection の有効期間中存在します。ただし、バッファーが指定された最大サイズに達した場合はその限りでありません。 その場合、ネイティブ・コードに対する呼び出しごとに、バッファーが解放されます。 Java コード側の対応するバッファーは、PreparedStatement.clearParameters および PreparedStatement.close 呼び出しが行われると解放されます。 アプリケーションが PreparedStatement.clearParameters を呼び出す際に、バッファーが最大サイズに達していなかった場合には、バッファーはクリアされません。

db2.jcc.maxRefreshInterval

ワークロード・バランシングにおいて、サーバー・リストのクライアント・コピーをリフレッシュする時間間隔の最大値を秒数で指定します。 有効な最小値は 1 です。

バージョン 3.63 または 4.13 以降では、 IBM Data Server Driver for JDBC and SQLJ、デフォルトは10秒です。 それより前のバージョンのドライバーの場合、デフォルトは 30 秒です。

db2.jcc.maxTransportObjectIdleTime

未使用のトランスポート・オブジェクトが、グローバル・トランスポート・オブジェクト・プール内に置かれてからこのプールから削除されるまでの期間を秒数で指定します。 トランスポート・オブジェクトは、接続コンセントレーターと Sysplex ワークロード・バランシングで使用されます。

db2.jcc.maxTransportObjectIdleTime のデフォルト値は60秒です。 db2.jcc.maxTransportObjectIdleTime を 0 より小さい値に設定すると、未使用のトランスポート・オブジェクトは即時にプールから削除されます。 0 より小さい値に設定することは、重大な性能低下の原因になる可能性があるので、お勧めしません。

db2.jcc.maxTransportObjects

接続コンセントレーターと Sysplex ワークロード・バランシング用のグローバル・トランスポート・オブジェクト・プール内のトランスポート・オブジェクト数の上限を指定します。 プール内のトランスポート・オブジェクトの数が db2.jcc.maxTransportObjects 値に達すると、db2.jcc.maxTransportObjectIdleTime 値を超えた期間使用されなかったトランスポート・オブジェクトは、プールから削除されます。

3.63 または 4.13 以降のバージョンでは、 IBM Data Server Driver for JDBC and SQLJ、デフォルトは1000です。 それよりも前のバージョンのドライバーの場合、デフォルトは -1 です。

0 以下の値は、グローバル・トランスポート・オブジェクト・プール内のトランスポート・オブジェクト数には制限がないことを意味します。

db2.jcc.maxTransportObjectWaitTime

db2.jcc.maxTransportObjects 値にまだ達していない場合に、アプリケーションがトランスポート・オブジェクトを待機する最大の時間を秒数で指定します。 トランスポート・オブジェクトは、接続コンセントレーターと Sysplex ワークロード・バランシングで使用されます。 アプリケーションが、db2.jcc.maxTransportObjectWaitTime 値よりも長い期間待機していると、グローバル・トランスポート・オブジェクト・プールは SQLException をスローします。

負の値は、アプリケーションはいつまでも待機することを意味します。

バージョン 3.63 または 4.13 以降では、 IBM Data Server Driver for JDBC and SQLJ、デフォルトは1秒です。 それよりも前のバージョンのドライバーの場合、デフォルトは -1 です。

db2.jcc.minTransportObjects

接続コンセントレーターと Sysplex ワークロード・バランシング用のグローバル・トランスポート・オブジェクト・プール内のトランスポート・オブジェクト数の下限を指定します。 JVM の作成時には、プール内にはトランスポート・オブジェクトは存在しません。 トランスポート・オブジェクトは、必要に応じてプールに追加されます。 db2.jcc.minTransportObjects 値に達した後は、JVM が存続するかぎり、グローバル・トランスポート・オブジェクト・プール内のトランスポート・オブジェクトの数が db2.jcc.minTransportObjects 値より小さくなることはありません。

db2.jcc.minTransportObjects のデフォルト値は 0 です。 0 以下の値は、グローバル・トランスポート・オブジェクト・プールが空になる可能性があることを意味します。

db2.jcc.onDataTruncation or db2.jcc.override.onDataTruncation

入力値が列に挿入された際に、その値がその列に対して大きすぎる場合に実行されるアクションを指定します。 IBM Data Server Driver for JDBC and SQLJ 入力値が列に挿入され、その値がその列に対して大きすぎる場合に取る db2.jcc.onDataTruncation db2.jcc.override.onDataTruncation は、 以降のバージョンのドライバーにのみ適用されます。 4.33 可能な値は以下のとおりです。

1

その IBM Data Server Driver for JDBC and SQLJ データが切り捨てられた場合に警告を発します。 この値がデフォルトです。

2

The IBM Data Server Driver for JDBC and SQLJ データが切り捨てられた場合、例外が発生します。

3

The IBM Data Server Driver for JDBC and SQLJ 何のアクションも起こさず、これは 4.33 以前のドライバーバージョンと同じ動作です。

db2.jcc.outputDirectory

一時的なログファイルを保存する場所を指定します。 IBM Data Server Driver for JDBC and SQLJ 一時的なログファイルを保存する場所を指定します。

このプロパティが設定されている場合、 IBM Data Server Driver for JDBC and SQLJ 指定されたディレクトリに以下のファイルを保存します

jccdiag.log

診断情報が含まれています。 IBM Data Server Driver for JDBC and SQLJ。

db2.jcc.outputDirectory が指定されていない場合、 IBM Data Server Driver for JDBC and SQLJjava.io.tmpdir システムプロパティで指定されたディレクトリを検索します。 java.io.tmpdir システム・プロパティーも指定されていない場合、ドライバーは jccdiag.log に診断情報を書き込みません。 ディレクトリーは指定されているものの jccdiag.log にアクセスできない場合、ドライバーは jccdiag.log に診断情報を書き込みません。

その IBM Data Server Driver for JDBC and SQLJ ディレクトリを作成しません。 手作業でディレクトリーを作成して、必要なファイル権限を割り当てる必要があります。

db2.jcc.outputDirectory では絶対パス、相対パスのどちらでも指定できます。 しかしながら、絶対パスをお勧めします。

db2.jcc.pkList

データ・ソースへの JDBC または SQLJ 接続が確立されるときに、基礎となる RRSAF CREATE THREAD 呼び出しで使用されるパッケージ・リストを指定します。 SQLJ プログラムまたは JDBC ドライバーでプランをバインドしない場合、 このプロパティーを指定します。 このプロパティーを指定する場合、db2.jcc.planName は指定しないでください。

db2.jcc.pkList IBM タイプ2接続 Data Server Driver for JDBC and SQLJ のみに適用されます。 Db2 for z/OS。 db2.jcc.pkList CICS または で実行されるアプリケーション、または Java ストアドプロシージャには適用されません。 IMS JDBC ドライバーは、これらの場合に db2.jcc.pkList 設定を無視します。

推奨: db2.jcc.planName ではなく、db2.jcc.pkList を使用してください。

パッケージ・リストのフォーマットは以下のとおりです。

db2.jcc.pkList のデフォルト値は NULLID.* です。

com.ibm.db2.jcc.DB2Binder を実行する際に -collection パラメータを指定した場合、 IBM Data Server Driver for JDBC and SQLJcom.ibm.db2.jcc.DB2Binder を実行する際にパッケージに指定するコレクションIDは、 db2.jcc.pkList プロパティのパッケージリストにも含まれている必要があります。

db2.jcc.pkList を上書きするには、 Connection または DataSource オブジェクトの pkList プロパティを設定します。

次の例では、パッケージがコレクションJDBCCIDにあるインスタンスのパッケージリストを指定します。 IBM Data Server Driver for JDBC and SQLJ パッケージがコレクションJDBCCIDにあるインスタンスのパッケージリストを指定します。 このドライバー・インスタンスの下で準備された SQLJ アプリケーションは、コレクション SQLJCID1、SQLJCID2、または SQLJCID3 にバインドされます。

db2.jcc.pkList=JDBCCID.*,SQLJCID1.*,SQLJCID2.*,SQLJCID3.*

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.planName

Db2 for z/OS データソースへの JDBC またはSQLJ接続が確立された際に、基礎となるRRSAF CREATE THREADコールで使用されるプラン名を指定します。 SQLJ プログラムおよび JDBC ドライバーでパッケージをバインドする場合、 このプロパティーを指定します。 このプロパティーを指定する場合、db2.jcc.pkList は指定しないでください。

db2.jcc.planName IBM タイプ2接続 Data Server Driver for JDBC and SQLJ のみに適用されます。 Db2 for z/OS。 db2.jcc.planName CICS または で実行されるアプリケーション、または Java ストアドプロシージャには適用されません。 IMS JDBC ドライバーは、これらの場合に db2.jcc.planName 設定を無視します。

このプロパティまたは db2.jcc.pkList プロパティを指定しない場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.pkList のデフォルト値であるNULLID.*が使用されます。

db2.jcc.planName を指定する場合は、com.ibm.db2.jcc.DB2Binder の実行時に作成するパッケージを、このプロパティーの値を名前とするプランにバインドする必要があります。 すべての SQLJ パッケージも、名前がこのプロパティーの値であるプランにバインドする必要があります。

db2.jcc.planName を上書きするには、 Connection または DataSource オブジェクトの planName プロパティを設定します。

次の例では、パッケージとSQLJパッケージに対してMYPLANというプラン名を指定しています。 IBM Data Server Driver for JDBC and SQLJJDBC パッケージとSQLJパッケージに指定します。

db2.jcc.planName=MYPLAN

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.progressiveStreaming or db2.jcc.override.progressiveStreaming

データ・ソース上で連続ストリーミングがサポートされている場合に、JDBC ドライバーが連続ストリーミングを使用するかどうかを指定します。

連続ストリーミングを使用すると、LOB または XML オブジェクトのサイズに基づいて、LOB または XML のデータを戻すのに最も効率のよいモードがデータ・ソースで動的に判別されます。 連続ストリーミングは、動的データ・フォーマットとも呼ばれます。

これらのプロパティーの有効な値として、以下の値があります。

1

データ・ソースがサポートしている場合は連続ストリーミングを使用します。

2

連続ストリーミングは使用しません。

db2.jcc.queryPrefetch or db2.jcc.override.queryPrefetch

指定するかどうかを指定します。 IBM Data Server Driver for JDBC and SQLJ テーブルから行を取得する際にクエリプリフェッチの動作を使用するかどうかを指定します。 Db2 テーブルから行を取得する際に 照会プリフェッチを使用すれば、アプリケーションが大量の結果セットを取得するときのパフォーマンスが向上します。 照会プリフェッチは、アプリケーションが LOB データや XML データを取得するときには使用されません。また、データの取得に使用されるカーソルが前方スクロール・カーソルでない場合にも使用されません。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。

可能な値は以下のとおりです。

true

IBM Data Server Driver for JDBC and SQLJ テーブルから行を取得する際にクエリプリフェッチを使用できることを指定します。

false

IBM Data Server Driver for JDBC and SQLJ テーブルから行を取得する際にクエリプリフェッチを使用しないことを指定します。 false がデフォルトです。

db2.jcc.remoteLoggingUrl

URL が に設定されている場合に、トレース出力を送信するリモート製品の を指定します。 IBM Data Server Driver for JDBC and SQLJdb2.jcc.enableRemoteLogging が true に設定されている場合に、トレース出力が送信されるリモート製品の を指定します。 以下に例を示します。

db2.jcc.remoteLoggingUrl=http://127.0.0.1:9200/

db2.jcc.remoteLoggingUrl の値が無効であったり、その URL に到達できない場合、ドライバーは、ドライバー・プロパティーで指定されたローカル・ファイルに出力を送信します。

db2.jcc.rollbackOnShutdown

Db2 for z/OS JVM シャットダウンフックの処理中に、ワーク単位の JDBC 接続でロールバック操作を強制し、それ以降の操作を無効にするかどうかを指定します。

db2.jcc.rollbackOnShutdown IBM タイプ2接続 Data Server Driver for JDBC and SQLJ のみに適用されます。

db2.jcc.rollbackOnShutdown CICS、、ストアドプロシージャ、または 環境には適用されません。 IMS WebSphere® Application Server

これらのプロパティーの有効な値として、以下の値があります。

yes or true

その IBM Data Server Driver for JDBC and SQLJDb2 for z/OS ロールバック操作を強制的に実行し、JVMシャットダウンフックの処理中にワーク単位となっている JDBC 接続に対するそれ以降の操作を無効にします。

その他の値

デフォルト値は、 IBM Data Server Driver for JDBC and SQLJ JVM シャットダウンフックの処理中はロールバック処理に関して何のアクションも行いません。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.securityMechanism or db2.jcc.override.securityMechanism

DRDAのセキュリティ機構を指定します。 可能な値は以下のとおりです。

3

ユーザー ID およびパスワード

4

ユーザー ID のみ

7

ユーザー ID および暗号化されたパスワード

9

暗号化されたユーザーIDとパスワード。 この値は、接続には適用されません。 IBM Informix。

11

Kerberos. この値は、接続には適用されません。 IBM Informix。

12

暗号化されたユーザー ID および暗号化されたセキュリティー・センシティブ・データ。 この値は、接続のみに適用されます。 Db2 for z/OS のみに適用されます。

13

暗号化されたユーザー ID とパスワード、および暗号化されたセキュリティー・センシティブ・データ。 この値は、接続には適用されません。 IBM Informix。

15

プラグイン・セキュリティー。 この値は、 Linux、UNIX、Windowsシステム上の Db2 への接続のみに適用されます。

16

暗号化されたユーザー ID。 この値は、接続には適用されません。 IBM Informix。

18

SSLを使用するクライアント証明書のセキュリティ。 この値は、接続のみに適用されます。 Db2 for z/OS のみに適用されます。

重要:

バージョン 4.33 から、 IBM Data Server Driver for JDBC and SQLJ、 db2.jcc.securityMechanism のデフォルト値は、暗号化されたユーザーIDとパスワードのセキュリティ（9）です。 データサーバーが暗号化されたユーザーIDとパスワードのセキュリティをサポートしていないが、ユーザーIDとパスワードのセキュリティ（3）をサポートしている場合、 IBM Data Server Driver for JDBC and SQLJ ドライバーはセキュリティ機構をユーザーIDとパスワードによるセキュリティ（3）に変更し、データサーバーへの接続を試みます。

ユーザーIDとパスワードによるセキュリティ（3）を使用してドライバーが接続を再試行すると、パフォーマンスが低下する可能性があります。 パフォーマンスへの影響を最小限に抑えるには、以下のいずれかの操作を行ってください

• クライアント側でセキュリティ機構をユーザーIDとパスワードのセキュリティ（3）に明示的に設定する。
• データサーバーの設定を変更し、暗号化されたユーザーIDとパスワードのセキュリティをサポートするようにします。

リクエスト側とデータサーバー側で、平文パスワードセキュリティおよび暗号化ユーザーID・パスワードセキュリティ以外のセキュリティメカニズムのサポートに不一致がある場合、エラーが発生します。

バージョン 4.33 以前の IBM Data Server Driver for JDBC and SQLJ、 db2.jcc.securityMechanism のデフォルト値はユーザーIDとパスワードのセキュリティ（3）です。 データサーバーがユーザーIDとパスワードのセキュリティをサポートしていないが、暗号化されたユーザーIDとパスワードのセキュリティ（9）をサポートしている場合、 IBM Data Server Driver for JDBC and SQLJ ドライバーはセキュリティメカニズムを暗号化ユーザーIDおよびパスワードセキュリティに変更し、データサーバーへの接続を試みます。 リクエスト側とデータサーバー側でセキュリティメカニズムのサポートにその他の不一致がある場合、エラーが発生します。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続には適用されません。 Db2 for z/OS。

db2.jcc.sendCharInputsUTF8

文字入力データを IBM Data Server Driver for JDBC and SQLJ 文字入力データをデータベースサーバーの CCSID に変換する Db2 for z/OS、または UTF-8 エンコーディングでデータが送信され、データベースサーバーで変換される。 db2.jcc.sendCharInputsUTF8 IBM タイプ2接続は Data Server Driver for JDBC and SQLJ Db2 for z/OS データベースサーバーのみに適用されます。 このプロパティーが接続レベルでも設定されている場合、接続レベルの設定がこの値をオーバーライドします。

これらのプロパティーの有効な値として、以下の値があります。

no, false, or 2

文字入力データを送信前にターゲットエンコーディングに変換する際のデフォルト値を指定します。 IBM Data Server Driver for JDBC and SQLJ データベースサーバーに送信される前に、文字入力データをターゲットエンコーディングに変換する Db2 for z/OS データベースサーバーに送信する前に

yes, true, or 1

文字入力データを送信することを指定します。 IBM Data Server Driver for JDBC and SQLJ 文字入力データを Db2 for z/OSUTF-8 エンコーディングでデータベースサーバーに送信する データ・ソースはデータを UTF-8 エンコードからターゲット CCSID に変換します。

SDK for Java によるターゲット CCSID への変換で文字変換の問題が発生する場合のみ、yes、true、または 1 を指定します。 最もよくある問題は、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続を使用して、CCSID 37のテーブル列にUnicodeの改行文字（ U+000A ）を挿入し、そのデータを z/OS 以外のクライアントから取得する場合に発生します。 Java用SDKが文字列を列に挿入する際に変換を行う場合、改行文字はEBCDICの改行文字X'15'に変換されます。 しかし、取得時に、 z/OS 以外のオペレーティングシステム用のJava SDKの一部は、X'15'文字を改行文字（ U+000A ）ではなく、Unicodeの次行文字（ U+0085 ）に変換します。 改行文字により、一部の XML パーサーが予期しない動作を起こします。 db2.jcc.sendCharInputsUTF8 を「はい」に設定すると、 Db2 for z/OS データベースサーバーは、列に挿入する際に U+000A 文字をEBCDICのラインフィード文字X'25'に変換します。そのため、この文字は常にラインフィード文字として取得されます。

データソース上のターゲットCCSIDへのデータの変換により、 IBM Data Server Driver for JDBC and SQLJ ドライバによる変換よりも多くのメモリを使用する可能性があります。 ドライバーは文字データの変換用のメモリーを、ソース・エンコードからデータ・ソースに送信されるデータのエンコードに割り振ります。 表列に送信される文字データに対してドライバーが割り振るスペースの量は、データの最大長に基づいて決まります。 UTF-8 データは各文字に最大で 3 バイトを必要とします。 そのため、ドライバーが UTF-8 データをデータ・ソースに送信する場合、ドライバーは入力データ内の最大文字数の 3 倍を割り振る必要があります。 ドライバーが変換を行う場合、ターゲット CCSID が 1 バイト CCSID であれば、ドライバーは入力データ内の最大文字数のみ割り振る必要があります。

例えば、 db2.jcc.sendCharInputsUTF8 に対して以下のいずれかの設定を行うと、 IBM Data Server Driver for JDBC and SQLJ データソースにデータを送信する前に、入力文字列をターゲットエンコーディングではなく UTF-8 に変換します

db2.jcc.sendCharInputsUTF8=yes
db2.jcc.sendCharInputsUTF8=true
db2.jcc.sendCharInputsUTF8=1

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.sqljStmtCacheSize

各 DefaultContext インスタンスおよび各 JVM スレッドについて、SQLJ ステートメント・キャッシュ内のステートメントの最大数を指定します。 この値は、64 ビットのマルチスレッド環境で実行される SQLJ ストアード・プロシージャーに適用されます。 デフォルトは、ステートメント 10 個です。

マルチスレッド環境では、 IBM Data Server Driver for JDBC and SQLJDefaultContext オブジェクトの各インスタンスに関連するステートメントをキャッシュします。このオブジェクトは、各JVMスレッドによって使用されます。 db2.jcc.sqljStmtCacheSize 値に達した後、ドライバーがステートメントをキャッシュに入れようとしたとき。 使用頻度が最も低いキャッシュ・ステートメントがパージされ、新しいステートメントに置き換えられます。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続の Db2 for z/OS バージョン11以降にのみ適用されます。

db2.jcc.sqljToolsExitJVMOnCompletion

db2sqljcustomize や db2sqljbind といった SQLJ ツールの基礎となっている Java プログラムが、 呼び出し側プログラムに戻る際に System.exit 呼び出しを発行するかどうかを指定します。

可能な値は以下のとおりです。

true

SQLJ ツールの基礎となる Java プログラムが、完了時に System.exit 呼び出しを発行するように指定します。 true がデフォルトです。

false

SQLJ ツールの基礎となる Java プログラムが、System.exit 呼び出しを発行しないように指定します。

db2.jcc.sqljUncustomizedWarningOrException

カスタマイズされていないSQLJアプリケーションが実行された際に実行されるアクションを指定します。 IBM Data Server Driver for JDBC and SQLJ カスタマイズされていないSQLJアプリケーションが実行された際に実行される動作を指定します。 db2.jcc.sqljUncustomizedWarningOrException は、次のような値をとることができます。

0

The IBM Data Server Driver for JDBC and SQLJ カスタマイズされていないSQLJアプリケーションが実行された際に、 Warning または Exception をスローしません。 値0がデフォルトです。

1

IBM Data Server Driver for JDBC and SQLJ カスタマイズされていないSQLJアプリケーションが実行されると、 Warning をスローします。

2

IBM Data Server Driver for JDBC and SQLJ カスタマイズされていないSQLJアプリケーションが実行されると、 Exception をスローします。

この構成プロパティは Db2 for z/OS または Db2 on Linux、UNIX、および Windows システムのみに適用されます。

db2.jcc.ssid

サブシステムを指定します。 Db2 for z/OS アプリケーションが接続するサブシステムを指定します。 IBM Data Server Driver for JDBC and SQLJ タイプ2接続 Db2 for z/OS。

db2.jcc.ssid の値は、ローカル Db2 サブシステムの名前、またはグループ接続名、あるいはサブグループ接続名にすることができます。

このプロパティーについて、以下の例で説明します。

db2.jcc.ssid=DB2A

ssid Connection および DataSource プロパティーは db2.jcc.ssid をオーバーライドします。

グループ添付名またはサブグループ添付名を指定し、 Db2 アプリケーションが接続しているサブシステムが停止した場合、接続は終了します。 しかし、新しい接続がそのグループアタッチメント名またはサブグループアタッチメント名を使用する場合、 Db2 for z/OS グループアタッチメントまたはサブグループアタッチメントの処理を使用して、接続先となるアクティブな Db2 接続先となるアクティブなサブシステムを

db2.jcc.ssid プロパティを指定しない場合、 IBM Data Server Driver for JDBC and SQLJ アプリケーションのデフォルトロードモジュールからSSID値を使用します。 インストールすると、 Db2 for z/OS、アプリケーションのデフォルトのロードモジュールがprefix.SDSNEXITデータセットと prefix.SDSNLOADデータセットに作成されます。 選択されたアプリケーション用に、他のデータ・セットの中でその他のアプリケーション・デフォルト・ロード・モジュールが作成されることがあります。

The IBM Data Server Driver for JDBC and SQLJ SSIDの値を読み込む前に、アプリケーションのデフォルトのロードモジュールをロードする必要があります。 z/OS アプリケーションのデフォルトのロードモジュールを検索するために、以下の場所にあるデータセットを以下の順序で検索します

1. ジョブ・パック域 (JPA)
2. TASKLIB
3. STEPLIB または JOBLIB
4. LPA
5. リンク・リストにあるライブラリー

お客様のシステムにアプリケーションのデフォルトロードモジュールのコピーが複数ある場合は、 z/OS が最初に正しいコピーを含むデータセットを見つけられるようにする必要があります。 IBM Data Server Driver for JDBC and SQLJ 最初

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.sslCertLocation or db2.jcc.override.sslCertLocation

トラステッド証明書ファイルのロケーションをアプリケーションが構成できることを指定します。 データベースサーバー証明書を所有するアプリケーションの場合、 sslCertLocation は、 IBM Data Server Driver for JDBC and SQLJ SSL接続用の証明書を信頼するように指示する このプロパティーを使用することで、Java トラストストア・データベースと関連ドライバーの構成に証明書をインポートする必要がなくなります。

sslCertLocation のデフォルト値は、db2.jcc.sslCertLocation 構成プロパティーによって提供されます。 db2.jcc.sslCertLocation 構成プロパティが指定されていない場合、 sslTruststoreLocation, および sslCertLocation プロパティは構成されず、 sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJ Java ランタイム環境のデフォルトのトラストストアを使用します。

db2.jcc.override.sslCertLocation プロパティーは、Connection または DataSource オブジェクトの sslCertLocation プロパティーをオーバーライドします。

db2.jcc.sslClientCertificateAlias or db2.jcc.override.sslClientCertificateAlias

Java キーストアにある証明書に対してクライアントが指定したエイリアスを指定します。 そのエイリアスに対応する証明書がSSL接続に使用される。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4の接続にのみ適用される。 Db2 for z/OS セキュリティの仕組みの値が TLS_CLIENT_CERTIFICATE_SECURITY (18) の場合。

db2.jcc.override.sslClientCertificationAlias プロパティは、 Connection または DataSource オブジェクトの sslClientCertificationAlias プロパティをオーバーライドします。

db2.jcc.sslClientHostnameValidation or db2.jcc.override.sslClientHostnameValidation

IBM Data Server Driver for JDBC and SQLJ トランスポート層セキュリティ（TLS）を使用するデータサーバーへの接続を確立する際に、クライアントホスト名の検証を行うかどうかを指定します。 ホスト名の妥当性検査は、IETF RFC 6125 に規定されている標準に従って実行されます。

sslClientHostnameValidation は、以下のいずれかの値をとることができます。

BASIC

ホスト名の妥当性検査を有効にすることを指定します。 TLS ハンドシェーク時に、データ・サーバーが証明書をドライバーに送信すると、ドライバーは証明書内のホスト名またはそれに対応する IP アドレスが、アプリケーションがドライバーに提供したホスト名またはそれに対応する IP アドレスに一致するかどうかを検査します。

OFF

ホスト名の妥当性検査を無効にすることを指定します。

デフォルト:

• ドライバー バージョン 4.34:BASIC デフォルトです。
• ドライバーのバージョン以前のデフォルトは、 4.34: OFF がデフォルトです。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4の接続にのみ適用され、 Db2 for z/OS、 Linux、UNIX、およびWindowsシステム上の Db2 にのみ適用されます。

db2.jcc.override.sslClientHostnameValidation プロパティーは、Connection または DataSource オブジェクトの sslClientHostnameValidation プロパティーをオーバーライドします。

db2.jcc.sslConnection or db2.jcc.override.sslConnection

IBM Data Server Driver for JDBC and SQLJ SSLソケットを使用してデータソースに接続するかどうかを指定します。 値が true の場合、接続は SSL ソケットを使用します。 値が false の場合、接続はプレーン・ソケットを使用します。

db2.jcc.override.sslConnection プロパティーは、Connection または DataSource オブジェクトの sslConnection プロパティーをオーバーライドします。

プロパティーが指定されていない場合、デフォルト値は false です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。

db2.jcc.sslKeyStoreLocation or db2.jcc.override.sslKeyStoreLocation

SSL接続用のクライアント証明書が格納されているクライアント上のJavaキーストアの名前を指定します。

この IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection プロパティが true に設定されている場合のみ、このオプションを使用します。

db2.jcc.sslKeyStoreLocation、 db2.jcc.override.sslKeyStoreLocation、または sslKeyStoreLocation が設定され、 db2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslKeyStoreLocation、 db2.jcc.override.sslKeyStoreLocation、または sslKeyStoreLocation の値を、 javax.net.ssl.keyStore のJavaプロパティの値の代わりに使用します。

db2.jcc.override.sslKeyStoreLocation プロパティーは、Connection または DataSource オブジェクトの sslKeyStoreLocation プロパティーをオーバーライドします。

プロパティーが指定されていない場合のデフォルト値は、null です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。この構成プロパティは、 Db2 for z/OS。

db2.jcc.sslKeyStorePassword or db2.jcc.override.sslKeyStorePassword

SSL接続用のクライアント証明書が格納されているクライアント上のJavaキーストアのパスワードを指定します。

この IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection プロパティが true に設定されている場合のみ、このオプションを使用します。

db2.jcc.sslKeyStorePassword、 db2.jcc.override.sslKeyStorePassword、または sslKeyStorePassword が設定され、 db2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslKeyStorePassword、 db2.jcc.override.sslKeyStorePassword、または sslKeyStorePassword の値を、 javax.net.ssl.keyStorePassword のJavaプロパティの値の代わりに使用します。

db2.jcc.override.sslKeyStorePassword プロパティーは、Connection または DataSource オブジェクトの sslKeyStorePassword プロパティーをオーバーライドします。

プロパティーが指定されていない場合のデフォルト値は、null です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。この構成プロパティは、 Db2 for z/OS。

db2.jcc.sslKeyStoreType or db2.jcc.override.sslKeyStoreType

SSL接続用のクライアント証明書が格納されているクライアント上のJavaキーストアのタイプを指定します。

この IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection プロパティが true に設定されている場合のみ、このオプションを使用します。

db2.jcc.sslKeyStoreType、 db2.jcc.override.sslKeyStoreType、または sslKeyStoreType が設定され、 db2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslKeyStoreType、 db2.jcc.override.sslKeyStoreType、または sslKeyStoreType の値を、 javax.net.ssl.keyStoreType のJavaプロパティの値の代わりに使用します。

db2.jcc.override.sslKeyStoreTypeproperty は、Connection または DataSource オブジェクトの sslKeyStoreType プロパティーをオーバーライドします。

プロパティーが指定されていない場合のデフォルト値は、null です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。この構成プロパティは、 Db2 for z/OS。

db2.jcc.sslTrustStoreLocation or db2.jcc.override.sslTrustStoreLocation

SSL 接続用のサーバー証明書が含まれるクライアント上の Java truststore の名前を指定します。

この IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection プロパティが true に設定されている場合のみ、このオプションを使用します。

db2.jcc.sslTrustStoreLocation、 db2.jcc.override.sslTrustStoreLocation、または sslTrustStoreLocation が設定され、 db2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslTrustStoreLocation、 db2.jcc.override.sslTrustStoreLocation、または sslTrustStoreLocation の値を、 javax.net.ssl.trustStore のJavaプロパティの値の代わりに使用します。

db2.jcc.override.sslTrustStoreLocation プロパティーは、Connection または DataSource のオブジェクトの sslTrustStoreLocation プロパティーをオーバーライドします。

プロパティーが指定されていない場合のデフォルト値は、null です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。

db2.jcc.sslTrustStorePassword or db2.jcc.override.sslTrustStorePassword

SSL 接続用のサーバー証明書が含まれるクライアント上の Java truststore のパスワードを指定します。

この IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection プロパティが true に設定されている場合のみ、このオプションを使用します。

db2.jcc.sslTrustStorePassword、 db2.jcc.override.sslTrustStorePassword、または sslTrustStorePassword が設定され、 db2.jcc.sslConnection、 db2.jcc.override.sslConnection、または sslConnection が true に設定されている場合、 IBM Data Server Driver for JDBC and SQLJdb2.jcc.sslTrustStorePassword、 db2.jcc.override.sslTrustStorePassword、または sslTrustStorePassword の値を、 javax.net.ssl.trustStorePassword のJavaプロパティの値の代わりに使用します。

db2.jcc.override.sslTrustStorePassword プロパティーは、Connection または DataSource オブジェクトの sslTrustStorePassword プロパティーをオーバーライドします。

プロパティーが指定されていない場合のデフォルト値は、null です。

このプロパティは、 IBM Data Server Driver for JDBC and SQLJ タイプ4接続のみに適用されます。

db2.jcc.stopTraceOnDiagErrorCodes

IBM Data Server Driver for JDBC and SQLJ データサーバーが指定のSQLエラーコードまたはSQL警告コードを生成した場合に、トレースを停止する。

このプロパティの値は、カンマ区切りのSQLエラーコードとSQL警告コードのリストです。 SQLエラーコードには、マイナス記号（-）を前置するか、アルファベット文字 n を後置することができます。 SQLの警告コードは、符号なし、プラス記号（+）を前置、または文字 p を後置して指定することができます。

例えば、SQL エラーコード -4499 または -4498、または SQL 警告コード +100 が返された際に、ドライバにトレースを停止するように指示するには、 db2.jcc.stopTraceOnDiagErrorCodes の値を以下のいずれかの形式で指定します

db2.jcc.stopTraceOnDiagErrorCodes=-4499,-4498,+100
db2.jcc.stopTraceOnDiagErrorCodes=-4499,4498n,100p
db2.jcc.stopTraceOnDiagErrorCodes=4499n,-4498,100

db2.jcc.stopTraceOnDiagErrorCodes IBM タイプ4接続 Data Server Driver for JDBC and SQLJ のみに適用されます。

db2.jcc.traceDirectory or db2.jcc.override.traceDirectory

Javaドライバコードのトレースを有効にし、 IBM Data Server Driver for JDBC and SQLJ Javaドライバコードのトレースを有効にし、トレース情報が書き込まれるディレクトリを指定します。 これらの条件は、 IBM Data Server Driver for JDBC and SQLJ タイプの 2 接続 （ Db2 for z/OS ）には適用されません。 db2.jcc.override.traceDirectory が指定された場合、同一の DataSource 上の複数の接続のトレース情報は、複数のファイルに書き込まれます。

db2.jcc.override.traceDirectory を指定すると、接続は file-name _origin_n という名前のファイルにトレースされます。

• n は DataSourceのn番目の接続です。
• db2.jcc.traceFileName と db2.jcc.override.traceFileName のどちらも指定されない場合、 file-name は traceFile になります。 db2.jcc.traceFileName または db2.jcc.override.traceFileName も指定されている場合、file-name は db2.jcc.traceFileName または db2.jcc.override.traceFileName の値になります。
• origin は、使用中のログ書き込みプログラムの起点を示します。 origin に指定できる値は次のとおりです。

  cpds

  DB2ConnectionPoolDataSource オブジェクトのログ書き込みプログラム。

  driver

  DB2Driver オブジェクトのログ書き込みプログラム。

  global

  DB2TraceManager オブジェクトのログ書き込みプログラム。

  sds

  DB2SimpleDataSource オブジェクトのログ書き込みプログラム。

  xads

  DB2XADataSource オブジェクトのログ書き込みプログラム。

db2.jcc.override.traceDirectory プロパティは、 Connection または DataSource オブジェクトの traceDirectory プロパティを上書きします。

例えば、 db2.jcc.override.traceDirectory に以下の設定を行うと、 IBM Data Server Driver for JDBC and SQLJ Javaコードから/SYSTEM /tmp という名前のディレクトリ内のファイルへのトレースが可能になります

db2.jcc.override.traceDirectory=/SYSTEM/tmp

IBM ソフトウェアサポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.traceLevel or db2.jcc.override.traceLevel

何をトレースするかを指定します。

db2.jcc.override.traceLevel プロパティは、 Connection または DataSource オブジェクトの traceLevel プロパティを上書きします。

10 進値を指定して、1 つ以上のトレース・レベルを指定します。 このトレース・レベルは、Connection または DataSource オブジェクトの traceLevel プロパティーに定義されているトレース・レベルと同じです。

複数のトレース・レベルを指定する場合には、値に対して OR (|) 演算を行い、db2.jcc.traceLevel または db2.jcc.override.traceLevel の指定に結果を 10 進数で指定します。

例えば、TRACE_DRDA_FLOWS および TRACE_CONNECTIONS を db2.jcc.override.traceLevel に指定するとします。 TRACE_DRDA_FLOWS の値は 16 進値 X'40' です。 TRACE_CONNECTION_CALLS の値は 16 進値 X'01' です。 両方のトレースを指定するには、ビット単位 OR 演算をその 2 つの値に対して行います。結果は X'41' になります。 これと等価の 10 進数は 65 です。それで、次のように指定します。

db2.jcc.override.traceLevel=65

db2.jcc.traceFile or db2.jcc.override.traceFile

Javaドライバーコードのトレースを有効にし、 IBM Data Server Driver for JDBC and SQLJ Javaドライバコードのトレースを有効にし、トレースファイル名が基づく名前を指定します。 db2.jcc.traceFile プロパティーは、 Db2 for z/OS 上の IBM Data Server Driver for JDBC and SQLJ タイプ 2 接続には適用されません。

db2.jcc.override.traceFile プロパティ値には、完全修飾された z/OS UNIX System Services ファイル名を指定してください。

db2.jcc.override.traceFile プロパティは、 Connection または DataSource オブジェクトの traceFile プロパティを上書きします。

例えば、 db2.jcc.override.traceFile に以下の設定を行うと、 IBM Data Server Driver for JDBC and SQLJ Javaコードを /SYSTEM/tmp/jdbctrace というファイルにトレースすることができます

db2.jcc.override.traceFile=/SYSTEM/tmp/jdbctrace

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.traceFileAppend or db2.jcc.override.traceFileAppend

db2.jcc.override.traceFile プロパティーによって指定されるファイルへ付加するか、 あるいは上書きするかを指定します。 これらの条件は、 IBM Data Server Driver for JDBC and SQLJ タイプの 2 接続 （ Db2 for z/OS ）には適用されません。 有効な値は true または false です。 デフォルトは false です。これは、traceFile プロパティーで指定されているファイルが上書きされることを意味します。

db2.jcc.override.traceFileAppend プロパティは、 Connection または DataSource オブジェクトの traceFileAppend プロパティを上書きします。

例えば、db2.jcc.override.traceFileAppend の設定を以下のように指定することによって、トレース・データは既存のトレース・ファイルに追加されるようになります。

db2.jcc.override.traceFileAppend=true

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.traceFileCount

循環トレースの場合のトレース・ファイルの最大数を指定します。 この IBM Data Server Driver for JDBC and SQLJdb2.jcc.traceOption が1に設定されている場合のみ、このプロパティを使用します。 デフォルト値は 2 です。

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.traceFileGlobalIdentifier

同じ IBM Data Server Driver for JDBC and SQLJ 構成プロパティー・ファイルを使用し、異なる Java 仮想マシン (JVM) で実行される複数の JDBC アプリケーションが固有のトレース・ファイルを持つことができるように、 IBM Data Server Driver for JDBC and SQLJ トレース・ファイル名に接尾部を追加することを指定します。 可能な値は以下のとおりです。

PID

ドライバーは、トレースファイル名にアンダースコア（_）とプロセスIDを追加します。

例えば、 db2.jcc.traceFile の値が SYSTEM/tmp/jdbctrace で、プロセスIDが12345であるとします。 結果として得られるトレースファイルの名前は、 SYSTEM/tmp/jdbctrace_12345 です。

ENV=JVM-システムプロパティ

ドライバーは、トレースファイル名にアンダースコア（_）とJVMシステムプロパティ値を追加します。

例えば、 db2.jcc.traceFile の値が SYSTEM/tmp/jdbctrace であると仮定します。 また、JVMシステムプロパティ MYJVM が indicator1 に設定されていると仮定します

System.setProperty("MYJVM", "indicator1");

結果として得られるトレースファイルの名前は、 SYSTEM/tmp/jdbctrace_indicator1 です。

db2.jcc.traceFileSize

循環トレースの場合に、各トレース・ファイルの最大サイズを指定します。 この IBM Data Server Driver for JDBC and SQLJdb2.jcc.traceOption が1に設定されている場合のみ、このプロパティを使用します。 デフォルト値は 10485760 (10 MB) です。

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.traceOption

トレース・データの収集方法を指定します。 このプロパティーのデータ・タイプは int です。 このプロパティーに指定できる値として、以下の値があります。

0

単一のトレース・ファイルが生成されてファイルのサイズに制限がないことを意味するデフォルト値を指定します。

1

円形トレースを行うことを指定します。 IBM Data Server Driver for JDBC and SQLJ 循環トレースを行う。 循環トレースは次のように行われます。

1. アプリケーションが最初のトレース・レコードを書き込む時に、ドライバーはファイルを作成します。
2. ドライバーはそのファイルにトレース・データを書き込みます。
3. ファイルのサイズがプロパティー db2.jcc.traceFileSize の値と等しくなったとき、ドライバーは別のファイルを作成します。
4. ドライバーは、データが書き込まれたファイルの数がプロパティ db2.jcc.traceFileCount の値に等しくなるまで、 手順2 と3 を繰り返します。
5. ドライバーは最初のトレース・ファイルに、既存のデータを上書きする形でデータを書き込みます。
6. ドライバーは、アプリケーションが完了するまで、 ステップ3 から5 を繰り返します。

トレース・ファイルのファイル名は、db2.jcc.traceFile、db2.jcc.override.traceFile、 db2.jcc.traceDirectory、db2.jcc.override.traceDirectory の各プロパティーによって決まるファイル名をベースにして、最初のファイルの末尾には .1 が付加され、2 番目のファイルには .2 が付加され、以降同様に番号が付加されます。

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

db2.jcc.tracePolling

グローバル設定ファイルの変更を IBM Data Server Driver for JDBC and SQLJ グローバル設定ファイルをポーリングしてトレースディレクティブの変更を確認し、新しいトレースディレクティブに合わせてトレースの動作を変更するかどうかを示します。 可能な値は true または false です。 3.69 以前のバージョンではデフォルトは false です IBM Data Server Driver for JDBC and SQLJ、バージョン 3.69 および 4.19 以降ではデフォルトがtrueです。 IBM Data Server Driver for JDBC and SQLJ。

The IBM Data Server Driver for JDBC and SQLJ 構成プロパティファイルが変更された後の次のポーリング間隔の開始時のトレース動作を変更します。 アプリケーションの実行中に db2.jcc.tracePolling が true に設定されると、トレースが有効になり、 トレースが有効になる前にアプリケーションにより作成されたすべての PreparedStatement オブジェクトに関する情報は、 トレースの宛先にダンプされます。

db2.jcc.tracePolling は、以下のグローバル構成プロパティーをポーリングします。

• db2.jcc.override.traceLevel
• db2.jcc.override.traceFile
• db2.jcc.override.traceDirectory
• db2.jcc.override.traceFileAppend
• db2.jcc.t2zosTraceFile
• db2.jcc.t2zosTraceBufferSize
• db2.jcc.t2zosTraceWrap

db2.jcc.tracePollingInterval

グローバル設定ファイルのトレースディレクティブの変更をポーリングする間隔（秒）を指定します。 IBM Data Server Driver for JDBC and SQLJ グローバル設定ファイルのトレースディレクティブの変更をポーリングする間隔を秒単位で指定します。 このプロパティー値は正の整数です。 デフォルトは 60 です。 指定したトレース・ポーリング間隔が使用されるには、ドライバーがロードされて初期化される前に db2.jcc.tracePollingInterval プロパティーを設定する必要があります。 ドライバーがロードされ初期化された後に db2.jcc.tracePollingInterval を変更しても、効果はありません。

db2.jcc.t2zosTraceFile

IBM Data Server Driver for JDBC and SQLJ タイプ 2 接続の C/C++ ネイティブ ドライバー コードの IBM Data Server Driver for JDBC and SQLJ トレースを有効にし、トレース ファイル名のベースとなる名前を指定します。 このプロパティーは、C/C++ ネイティブ・ドライバー・コードのトレース・データの収集に必要です。

db2.jcct.t2zosTraceFile プロパティ値には、完全修飾された z/OS UNIX System Services ファイル名を指定してください。

例えば、 db2.jcct.t2zosTraceFile に以下の設定を指定すると、 IBM Data Server Driver for JDBC and SQLJ C/C++のネイティブコードを特定のファイルにトレースすることができます。 /SYSTEM/tmp/jdbctraceNative:

db2.jcc.t2zosTraceFile=/SYSTEM/tmp/jdbctraceNative

IBM サポートの指示に従って、トレースプロパティを設定してください。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.t2zosTraceBufferSize

C/C++ ネイティブ・ドライバー・コードによって実行される処理をトレースするのに使用される仮想ストレージ内のトレース・バッファーのサイズを KB 単位で指定します。 この値は、収集できる C/C++ ネイティブ・ドライバーのトレース情報の最大量でもあります。

64 (64 KB) から 4096 (4096 KB) までの整数を指定します。 デフォルトは 256 (256 KB) です。

JDBC ドライバーは、トレース・バッファーのサイズを次の表に示すようにして決定します。

指定された値 (n)	トレース・バッファーのサイズ (KB)
<64	64
64<=n<= 128	64
1 28&lt;=n &lt;256	128
256<=n <512	256
512<=n<= 1024	512
1024≦n≦2048	1024
2048≦n≦ 4096	2048
n>=4096	4096

db2.jcc.t2zosTraceBufferSize は、db2.jcc.t2zosTraceFile プロパティーが設定されている場合にのみ使用されます。

推奨: パフォーマンスへの影響を避けるために、1024 以下の値を指定してください。

例えば、トレース・バッファーのサイズを 1024 KB に設定するには、以下の設定を使用します。

db2.jcc.t2zosTraceBufferSize=1024

IBM サポートの指示に従って、トレースプロパティを設定する必要があります。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.t2zosTraceWrap

SQLJ トレースの折り返しを使用可能または使用不可にします。 db2.jcc.t2zosTraceWrap は以下の値をとることができます。

1

トレースを折り返します。

0

トレースを折り返しません。

デフォルトは 1 です。 このパラメーターはオプションです。 以下の例では、このプロパティーの設定方法について説明します。

DB2SQLJ_TRACE_WRAP=0

db2.jcc.t2zosTraceWrap の設定は、 IBM サポートの指示に従ってのみ行ってください。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.useCcsid420ShapedConverter

EBCDIC CCSID 420 であるアラビア語文字データが Cp420S エンコードにマップするかどうかを指定します。

db2.jcc.useCcsid420ShapedConverter データベースサーバーへの接続のみに適用されます。 Db2 for z/OS データベースサーバーへの接続のみに適用されます。

db2.jcc.useCcsid420ShapedConverter の値が true の場合、CCSID 420 は Cp420S エンコードに対応します。 db2.jcc.useCcsid420ShapedConverter の値が false の場合、CCSID 420 は Cp420 エンコードに対応します。 値 false がデフォルトです。

この構成プロパティは、のみに適用されます。 Db2 for z/OS。

db2.jcc.useClientSideLicenseFirst or db2.jcc.override.useClientSideLicenseFirst

データサーバーへのアクセス許可を得るために、サーバーサイドのライセンスの前にクライアントサイドのライセンスをチェックするかどうかを指定します。 IBM Data Server Driver for JDBC and SQLJ データサーバーへのアクセス許可を得るために、サーバーサイドのライセンスの前にクライアントサイドのライセンスをチェックするかどうかを指定します。

useClientSideLicenseFirst は、以下のいずれかの値をとることができます。

1

クライアント・サイドのライセンスが存在するかどうかを検査し、存在する場合はそれを使用して接続の妥当性検査を実行します。 クライアント・サイドのライセンスが存在しない場合は、サーバー・サイドのライセンスを検査します。 どちらのライセンスも存在しない場合、ドライバーは LicenseException をスローします。

2 or 0

サーバー・サイドのライセンスが存在するかどうかを検査し、存在する場合はそれを使用して接続の妥当性検査を実行します。 サーバー・サイドのライセンスが存在しない場合は、クライアント・サイドのライセンスを検査します。 どちらのライセンスも存在しない場合、ドライバーは LicenseException をスローします。 これがデフォルトの動作です。

db2.jcc.useClientSideLicenseFirst IBM タイプ4接続 Data Server Driver for JDBC and SQLJ に適用されます。 Db2 for z/OS、 Db2 for IBM i、および Db2 on Cloud、 IBM Data Server Driver for JDBC and SQLJ タイプ2接続については Db2 for z/OS。