Db2 ODBC 初期化キーワード
Db2® ODBC 初期化キーワードは、Db2 ODBC アプリケーションのランタイム環境を制御します。
その際、各キーワードを定義すべき初期化ファイル中のセクション (共通、サブシステム、 またはデータ・ソース) も示しています。
- ACCOUNTINGINTERVAL = COMMIT
- このキーワードは、サブシステム・セクションに置かれます。
ACCOUNTINGINTERVAL キーワードを使用して、Db2 アカウント・レコードをコミット・ポイントで作成するかどうかを指定します。ACCOUNTINGINTERNVAL を COMMIT に設定した場合、トランザクションが接続ハンドルでコミットされるたびに、アカウンティング・レコードが作成されます。ACCOUNTINGINTERVAL が指定されていない場合、または COMMIT 以外のキーワード値が指定された場合は、接続ハンドルでの物理接続が終了する時に、アカウント・レコードが作成されます。
Db2 ODBC は、MVSATTACHTYPE=CAF が指定された場合、または Db2 ODBC アプリケーションが Db2 for z/OS® ストアード・プロシージャーとして実行されている場合は、ACCOUNTINGINTERVAL を無視します。
- APPLTRACE = 0 | 1
- このキーワードは、共通セクションに置かれます。
APPLTRACE キーワードは、Db2 ODBC アプリケーション・トレースを 使用可能にするかどうかを制御します。アプリケーション・トレースは、アプリケーション・エラーの診断用に設計されています。 アプリケーション・トレースを使用可能にした場合、アプリケーションから任意の Db2 ODBC API への 呼び出しは、すべて、入力パラメーターを含めてトレースされます。 このトレース 結果は、APPLTRACEFILENAME キーワードで指定されたファイルへ書き込まれます。
- 0
- 無効 (デフォルト)
- 1
- 有効
- APPLTRACEFILENAME = dataset_name
- このキーワードは、共通セクションに置かれます。
APPLTRACEFILENAME は、 トレースが APPLTRACE キーワードで開始された 場合にのみ、使用されます。APPLTRACE を 1 に設定した場合は、APPLTRACEFILENAME キーワードを使用して、Db2 ODBC アプリケーション・トレースを記録する z/OS データ・セット名 または z/OS UNIX 環境 HFS ファイル名を示します。
- AUTOCOMMIT = 1 | 0
- このキーワードは、データ・ソース・セクションに置かれます。ODBC との整合性を保つために、Db2 ODBC は、デフォルトを AUTOCOMMIT オン にしています。これは、それぞれのステートメントが単一で完全なトランザクション として扱われることを意味します。 このキーワードでは、代わりのデフォルトを設定できますが、 アプリケーションがプログラムの一部として AUTOCOMMIT の値を指定しない場合にのみ使用されます。
- 1
- オン (デフォルト)
- 0
- オフ
ほとんどの ODBC アプリケーションでは、AUTOCOMMIT のデフォルトをオンであると想定しています。実行時にこのデフォルトをオーバーライドする場合は、細心の注意を払ってください。 アプリケーションが正しく動作するかどうかは、このデフォルトに依存していることがあるからです。
このキーワードでは、2 種類の値しか指定できませんが、分散作業単位 (DUW) 環境 で AUTOCOMMIT を使用可能にするかどうかを指定することもできます。 ある接続が整合 DUW の一部で、かつ AUTOCOMMIT が設定されていない場合には、デフォルトは適用されません。 自動コミット処理から生じる暗黙コミットは抑制されます。 AUTOCOMMIT が 1 に設定されており、かつその接続が整合 DUW の一部である場合には、 暗黙コミットが処理されます。この状態では、深刻なパフォーマンス低下を招き、その他予期しない結果が DUW システム内のどこかで発生する恐れがあります。しかし、これを使用可能にしないと、アプリケーションによってはまったく作動しない場合もあります。
アプリケーションを DUW 環境に適用する前に、そのアプリケーションのトランザクション処理についてよく理解しておく必要があります。特にサード・パーティーの作成したアプリケーションの場合は注意してください。
アプリケーションでグローバル・トランザクション処理を使用可能にする場合 は、AUTOCOMMIT=0, MULTICONTEXT=0、および MVSATTACHTYPE=RRSAF を 指定します。
- BITDATA = 1 | 0
- このキーワードは、データ・ソース・セクションに置かれます。
BITDATA キーワードを使用して、ODBC SQL_BINARY、SQL_VARBINARY、SQL_LONGVARBINARY、および SQL_BLOB タイプを、バイナリー形式のデータとして報告するかどうかを指定できます。 IBM® データベース・サーバーは FOR BIT DATA 属性で CHAR、VARCHAR および LONG VARCHAR 列を定義することにより、あるいは BINARY または VARBINARY 列を定義することによって、バイナリー・データ・タイプを持つ列をサポートします。
FOR BIT DATA、BLOB、BINARY、または VARBINARY として定義されたすべての列に文字データのみが含まれていて、アプリケーションがバイナリー・データ列を表示できないということが確実な場合のみ、BITDATA = 0 を設定してください。
- 1
- FOR BIT DATA、BLOB、BINARY、または VARBINARY データ・タイプをバイナリー・データとして報告します。 この値がデフォルトです。
- 0
- FOR BIT DATA、BLOB、BINARY、または VARBINARY データ・タイプを文字データとして報告します。
- CLISCHEMA = schema_name
このキーワードは 推奨されていません。
このキーワードを指定すると、ODBC ドライバーは、 カタログ情報を取得するデータベース・メタデータ・ストアード・プロシージャーを使用しません。
- COLLECTIONID = collection_id
- このキーワードは、データ・ソース・セクションに置かれます。
サーバーで割り振られるパッケージ名を解決するために使用するコレクション ID を指定することができます。 このパッケージは、後続の SQL ステートメントの実行をサポートします。
値は文字ストリングであり、128 文字を超えてはなりません。 この値は SET CURRENT PACKAGESET ステートメントを実行することによって、 オーバーライドすることができます。
- CONCURRENTACCESSRESOLUTION = 0 | 1 | 2| 3
- CONCURRENTACCESSRESOLUTION キーワードは、読み取りトランザクションで非コミット・データへのアクセスを解決する方法を制御します。
- 0
- 設定なし。この値がデフォルト値です。
- 1
- USE CURRENTLY COMMITTED。 読み取りトランザクションは、データが更新中または削除中である場合、現在のコミット済みバージョンのデータにアクセスできます。 挿入中の行はスキップされます。 この値が設定されると、すべてのユーザー SELECT ステートメントが USE CURRENTLY COMMITTED 属性を使用して準備されます。 このオプションが適用されるのは、カーソル固定 (CS) または読み取り固定 (RS) 分離が有効になっている場合のみです。
- 2
- WAIT FOR OUTCOME。 更新中または削除中のデータにアクセスする必要がある読み取りトランザクションは、COMMIT または ROLLBACK 操作が完了するまで待つ必要があります。 挿入される過程にある行はスキップされません。この値が設定されると、すべてのユーザー SELECT ステートメントが WAIT FOR COMMIT 属性を使用して準備されます。
- 3
- SKIP LOCKED DATA。 読み取りトランザクションは、他のトランザクションによって相容れないロックが掛けられている行をスキップできます。 この値が設定されると、すべてのユーザー SELECT ステートメントが SKIP LOCKED 属性を使用して準備されます。 このオプションが適用されるのは、カーソル固定 (CS) または読み取り固定 (RS) 分離が有効になっている場合のみです。
CONCURRENTACCESSRESOLUTION=1 の場合、Db2 で現在コミットされているセマンティクスに適用されるのものと同じ規則および制限が、ODBC にも適用されます。 バージョン 10 以降では、現在コミットされているデータへのアクセスは、非コミットの INSERT および DELETE 操作についてのみサポートされます。 読み取りトランザクションは、非コミットの UPDATE 操作については完了するまで待つ必要があります。
- CONNECTTYPE = 1 | 2
- このキーワードは、共通セクションに置かれます。
CONNECTTYPE キーワードを使用して、データ・ソースに対するすべての接続のデフォルト接続タイプを指定することができます。
- 1
- それぞれのコミット範囲がある、複数の同時接続。 MULTICONTEXT=0 が指定されている場合、現行接続での現行トランザクションがトランザクション境界上にない限り、新しい接続は追加されないことがあります (コミットもしくはロールバックされます)。この値がデフォルトです。
- 2
- 複数のデータ・ソースが関与する、同じ分散作業単位のもとでの整合接続。 CONNECTTYPE=2 は、MULTICONTEXT=1 が指定されている場合には無視されます。
- CURRENTAPPENSCH = EBCDIC | UNICODE | ASCII | ccsid
- このキーワードは、共通セクションに置かれます。
CURRENTAPPENSCH キーワードを使用して、以下の項目のいずれかを指定します。
- 以下の項目のために、ODBC ドライバーが使用するコード化スキーム (Unicode、EBCDIC、または ASCII)
- シンボリック C データ・タイプ SQL_C_CHAR を使用する、バインド済みの入力または出力ホスト変数
- 汎用 API 呼び出しの文字ストリング引数
- 以下の情報を ODBC ドライバーに与える CCSID 値。
- コード化スキームが提供する同じ情報。ODBC ドライバーは、コード化スキームを CCSID 値から引き出します。
- ステートメント属性 SQL_CCSID_CHAR および SQL_CCSID_GRAPHIC のデフォルト値。CCSID 値は、SQL_C_CHAR データ・タイプを持つアプリケーション・データの DSNHDECP ロード・モジュールで、デフォルトの CCSID 設定値をオーバーライドします。
UCS-2 ストリング引数をサポートする接尾部 W の API は、CURRENTAPPENSCH の影響を受けません。シンボリック C データ・タイプ SQL_C_WCHAR を使用するバインド済みの入力または出力ホスト変数の場合、ODBC は CURRENTAPPENSCH の値に関係なく UCS-2 を想定します。
CURRENTAPPENSCH にコード化スキームを指定した場合の結果: CURRENTAPPENSCH に EBCDIC、ASCII、または UNICODE を設定した場合、正常に接続した後に、SET CURRENT APPLICATION ENCODING SCHEME ステートメントがデータ・ソースに送信されます。このキーワードがない場合は、ドライバーはデフォルトのアプリケーションのコード化スキーム として、EBCDIC を想定します。
CURRENTAPPENSCH に CCSID を指定した場合の結果: CURRENTAPPENSCH に CCSID 値を設定した場合、CCSID 値は、以下のように、ステートメント属性 SQL_CCSID_CHAR および SQL_CCSID_GRAPHIC に対してデフォルト値を提供します。- ccsid が SBCS CCSID の場合、ccsid は SQL_CCSID_CHAR のデフォルト値です。SQL_CCSID_DEFAULT は SQL_CCSID_GRAPHIC のデフォルト値です。
- ccsid が DBCS CCSID の場合、ccsid は SQL_CCSID_GRAPHIC のデフォルト値です。SQL_CCSID_DEFAULT は SQL_CCSID_CHAR のデフォルト値です。
ccsid に対して、いずれかの UCS-2 CCSID (1200、13488、または 17584) を指定することは、CURRENTAPPENSCH=UNICODE を指定することに相当します。ccsid にこれらの値がある場合、ccsid は、SQL_CCSID_GRAPHIC のデフォルト値ではありません。
- ccsid が混合 CCSID の場合、ccsid は SQL_CCSID_CHAR のデフォルト値です。ccsid から派生した DBCS CCSID は SQL_CCSID_GRAPHIC のデフォルト値です。
ccsid が 1208 の場合、1208 は SQL_CCSID_CHAR のデフォルト値です。SQL_CCSID_DEFAULT は SQL_CCSID_GRAPHIC のデフォルト値です。
アプリケーションで SQLSetStmtAttr() を呼び出し、SQL_CCSID_CHAR または SQL_CCSID_GRAPHIC を設定する場合、これらの値が CURRENTAPPENSCH で設定されたデフォルトの CCSID 値をオーバーライドします。
CURRENTAPPENSCH を指定しないか、CURRENTAPPENSCH に無効値を指定した場合の結果: CURRENTAPPENSCH が指定されない、または CURRENTAPPENSCH 値が無効な場合、ODBC ドライバーはデフォルト・アプリケーション・コード化スキームとして EBCDIC を使用します。
- 以下の項目のために、ODBC ドライバーが使用するコード化スキーム (Unicode、EBCDIC、または ASCII)
- CURRENTFUNCTIONPATH = "'schema1', 'schema2' ,…"
- このキーワードは、データ・ソース・セクションに置かれます。
CURRENTFUNCTIONPATH キーワードは、 動的 SQL ステートメントで使用される、非修飾ユーザー定義関数、特殊タイプ、ストアード・プロシージャー参照の解決に使用されるパスの定義に使用します。 これには 1 つ以上のスキーマ名から成るリストがあり、それを使用して CURRENT PATH 特殊レジスターを設定します。 SET CURRENT PATH SQL は、データ・ソースへの接続時に value ステートメントを設定するために使用されます。 キーワード・ストリング内のそれぞれのスキーマ名は、単一引用符で区切り、コンマで分離する必要があります。キーワード・ストリング全体は、二重引用符で囲む必要があり、2048 文字を超えてはなりません。
CURRENT PATH 特殊レジスターのデフォルト値は次のとおりです。
X は、区切り ID としての USER 特殊レジスターの値です。 スキーマ SYSIBM、SYSFUN、および SYSPROC は、指定する必要はありません。これらのスキーマがいずれも現行パスに組み込まれていない場合、Db2 は、それぞれのスキーマ名がデフォルト値で示される順序でパスを開始するものと暗黙的に想定します。 パスにおけるスキーマ名の順序によって、名前が解決される順序が決まります。"SYSIBM", "SYSFUN", "SYSPROC", X非修飾ユーザー定義関数、特殊タイプ、およびストアード・プロシージャーは、CURRENTFUNCTIONPATH の設定に指定されたスキーマ・リストから、指定された順序で検索されます。ユーザー定義関数、特殊タイプ、またはストアード・プロシージャーが、指定されたスキーマで 見つからなかった場合は、リスト上の次に指定されたスキーマで検索が続行されます。 例えば、次のとおりです。
この CURRENTFUNCTIONPATH の設定値の例では、スキーマ "USER01" が検索され、 その次にスキーマ "PAYROLL"、その後スキーマ "SYSIBM" が検索される、以下同様、となります。CURRENTFUNCTIONPATH="'USER01', 'PAYROLL', 'SYSIBM', 'SYSFUN', 'SYSPROC'"SQL ステートメント CALL は静的ステートメントですが、ストアード・プロシージャー名がホスト変数を用いて指定されている場合 (それによって CALL ステートメントが疑似動的 SQL ステートメントになります)、CURRENTFUNCTIONPATH の設定が CALL ステートメントに影響を及ぼします。このことは、Db2 ODBC によって処理される CALL ステートメントの場合は常に該当します。
- CURRENTSQLID = current_sqlid
- このキーワードは、データ・ソース・セクションに置かれます。
CURRENTSQLID キーワードは、SET CURRENT SQLID をサポートしている Db2 データベース・サーバー (Db2 for z/OS など) に対してのみ有効です。このキーワードがあると、接続が成功した後、SET CURRENT SQLID ステートメント がデータベース・サーバーへ送られます。ユーザーおよびアプリケーションは、スキーマ名で修飾せずに SQL オブジェクトを指定することができます。 current_sqlid で指定する値は、128 バイトを超えてはなりません。
DYNAMICRULES(BIND) を指定して Db2 ODBC パッケージをバインド する場合は、このキーワードを指定しないでください。
- CURSORHOLD = 1 | 0
- このキーワードは、データ・ソース・セクションに置かれます。CURSORHOLD キーワードは、オープン・カーソルに対してトランザクション完了の影響を制御します。
- 1
- カーソル保留。 トランザクションをコミットする際にカーソルは破棄されません。 これはデフォルトです。
- 0
- カーソル保留なし。 トランザクションをコミットする際にカーソルは破棄されます。
トランザクションがロールバックされる際には、カーソルは常に破棄されます。
次の条件が両方とも満たされる場合は、アプリケーションのパフォーマンスを向上させるために、 このキーワードにはゼロを指定してください。
アプリケーションの動作は、SQL_CURSOR_COMMIT_BEHAVIOR または SQL_CURSOR_ROLLBACK_BEHAVIOR の SQLGetInfo() によって返される情報に依存しない。
- アプリケーションは、あるトランザクションから次トランザクションへのカーソルの保存を 要求しない。
トランザクション終了後はリソースを管理する必要がなくなるため、データベース・サーバーは より効率的に作動します。
- DB2EXPLAIN = 0 | 1 | 2 | 3
- このキーワードは、データ・ソース・セクションに置かれます。
DB2EXPLAIN キーワードは、CURRENT EXPLAIN MODE 特殊レジスターを YES または NO のいずれかに設定します。 以下のいずれかの値を指定できます。
- 0
- CURRENT EXPLAIN MODE 特殊レジスターを NO に設定します。これにより、EXPLAIN 機能が無効になります。この場合、Db2 は EXPLAIN 可能な動的ステートメントの実行時に EXPLAIN 情報を収集しません。この値がデフォルトです。
- 1
- 値 0 と同じ効果になります。この値は、Db2 ファミリーの互換性のためにサポートされています。Db2 for Linux, UNIX, and Windows の場合、値 1 の意味は異なりますが、Db2 for z/OS の場合、値 1 は値 0 と同じ意味です。
- 2
- CURRENT EXPLAIN MODE 特殊レジスターを YES に設定します。これにより、EXPLAIN 機能が有効になります。この場合、Db2 は EXPLAIN 可能な動的 SQL ステートメントに対して EXPLAIN 表に EXPLAIN 情報を挿入します。
- 3
- 値 2 と同じ効果になります。この値は、Db2 ファミリーの互換性のためにサポートされています。Db2 for Linux, UNIX, and Windows の場合、値 3 の意味は異なりますが、Db2 for z/OS の場合、値 3 は値 2 と同じ意味です。
または、SQL_ATTR_DB2EXPLAIN 属性を指定した SQLSetConnectAttr() 関数あるいは SET CURRENT EXPLAIN MODE SQL ステートメントを使用することで、ODBC アプリケーション用の CURRENT EXPLAIN MODE 特殊レジスターを設定できます。
CURRENT EXPLAIN MODE 特殊レジスターを EXPLAIN に設定する場合、SET CURRENT EXPLAIN MODE ステートメントを使用する必要があります。
目的の EXPLAIN 動作を実行するには、REOPT バインド・オプションをどのように設定するかを考慮する必要もあります。
- DBNAME = dbname
- このキーワードは、データ・ソース・セクションに置かれます。
DBNAME キーワードは、Db2 for z/OS に接続する場合のみ、かつ、アプリケーションが (基本) 表カタログ情報を要求する場合のみ、使用されます。
多数の表が Db2 for z/OS サブシステムに存在する場合、dbname を指定すると、そのデータベースに対して表情報用のカタログ照会処理に要する時間を減らし、 アプリケーションに戻される表の数を減らすことができます。
dbname キーワード値は、Db2 for z/OS カタログ表の DBNAME 列にマップされます。DBNAME 値が無指定か、あるいはビュー、シノニム、システム表、または別名 も TABLETYPE で指定されている場合には、表情報のみが照会されず、 ビュー、別名、およびシノニムは DBNAME では照会されます。 このキーワードを SCHEMALIST および TABLETYPE と使用して、情報が戻される表の数をさらに制限することができます。
- DECIMALFLOATROUNDINGMODE=0 | 1 | 2 | 3 | 4 | 5 | 6
- このキーワードは、データ・ソース・セクションに置かれます。
- DECIMALFLOATROUNDINGMODE は、DECFLOAT データ値が取り扱われる際に使用される丸めモードを指定します。DECIMALFLOATROUNDINGMODE がある場合、正常に接続された後に、Db2 ODBC は SET CURRENT DECFLOAT ROUNDING MODE ステートメントをデータ・ソースに送信します。DECIMALFLOATROUNDINGMODE がない場合は、データ・ソースで ROUND_HALF_EVEN が想定されます。可能な値および対応する CURRENT DECFLOAT ROUNDING MODE 値は、以下のとおりです。
- 0
- ROUND_HALF_EVEN
最も近い整数に丸めます。値が 2 つの整数から等距離にある場合、最終桁が偶数になるように丸めます。
- 1
- ROUND_HALF_UP
最も近い整数に丸めます。値が 2 つの整数から等距離にある場合、切り上げます。
- 2
- ROUND_DOWN
0 に丸めます。これは切り捨てに相当します。
- 3
- ROUND_CEILING
正の無限大方向に丸めます。
- 4
- ROUND_FLOOR
負の無限大方向に丸めます。
- 5
- ROUND_HALF_DOWN
最も近い整数に丸めます。値が 2 つの整数から等距離にある場合、切り捨てます。
- 6
- ROUND_UP
ゼロから離れるように丸めます。
- DIAGTRACE = 0 | 1
- このキーワードは、共通セクションに置かれます。
DIAGTRACE キーワードを使用して、Db2 ODBC 診断トレースを有効にできます。
- 0
- Db2 ODBC 診断トレースは無効。
診断データは収集されません。これはデフォルトです。
DIAGTRACE キーワードが 0 に設定されている場合、適切な ODBC 診断トレース・コマンドを使用することで、診断トレースを有効にできます。
- 1
- Db2 ODBC 診断トレースが有効。 診断データが、アプリケーションのアドレス・スペースに記録されます。 z/OS データ・セットまたは z/OS UNIX 環境の HFS ファイル名を 示す DSNAOTRC データ定義ステートメントをジョブまたは TSO ログオン・プロシージャーに 組み込んでいる場合は、トレースはプログラムの正常終了時に外部的に書き出し ます。適切な ODBC 診断トレース・コマンドを使用することで、トレースをフォーマット設定できます。
- DIAGTRACE_BUFFER_SIZE = buffer size
- このキーワードは、共通セクションに置かれます。
DIAGTRACE_BUFFER_SIZE キーワードは、Db2 ODBC 診断トレース・バッファー のサイズを制御します。 このキーワードが使用されるのは、DIAGTRACE キーワードを使用して トレースが開始される場合のみです。
buffer size 値は、トレース・バッファー用として割り振るバイト数を表す整数値です。バッファー・サイズは、65536 (64 K) の倍数に切り捨てられます。 指定した値が 65536 よりも小さい場合、65536 が使用されます。トレース・バッファー・サイズのデフォルト値は 65536 です。 64 ビット・アプリケーションの場合、31 ビット・アプリケーションに指定する値よりも最大で 10% 上回る buffer size 値を指定してください。
トレースがアクティブである場合は、このキーワードは無視されます。
- DIAGTRACE_NO_WRAP = 0 | 1
- このキーワードは、共通セクションに置かれます。
DIAGTRACE_NO_WRAP キーワードは、Db2 ODBC 診断トレース・バッファーが いっぱいになったときの Db2 ODBC 診断トレースの動作を制御します。このキーワードが使用されるのは、トレースが DIAGTRACE キーワードによって 開始される場合のみです。
- 0
- トレース表は循環して先頭から上書きするトレースです。 この場合、トレースは、最新のトレース・レコードを取り込むために アクティブのままになっています。これはデフォルトです。
- 1
- トレースは、トレース・バッファーがいっぱいになるとレコードの取り込みを停止します。 このトレースでは、既に書き込まれた初期のトレース・レコードを収集することになります。
トレースがアクティブである場合は、このキーワードは無視されます。
- DIAGTRACE = 0 | 1
- このキーワードは、共通セクションに置かれます。
DIAGTRACE キーワードを使用して、Db2 ODBC 診断トレースを有効にできます。
- 0
- Db2 ODBC 診断トレースは無効。
診断データは収集されません。これがデフォルトです。
DIAGTRACE キーワードが 0 に設定されている場合、適切な ODBC 診断トレース・コマンドを使用することで、診断トレースを有効にできます。
- 1
- Db2 ODBC 診断トレースが有効。 診断データが、アプリケーションのアドレス・スペースに記録されます。 z/OS データ・セットまたは z/OS UNIX 環境の HFS ファイル名を 示す DSNAOTRC データ定義ステートメントをジョブまたは TSO ログオン・プロシージャーに 組み込んでいる場合は、トレースはプログラムの正常終了時に外部的に書き出し ます。適切な ODBC 診断トレース・コマンドを使用することで、トレースをフォーマット設定できます。
- DIAGTRACE_MASK = *.*.*.*.* | trace_mask
- このキーワードは、共通セクションに置かれます。
DIAGTRACE_MASK は、トレース・マスクを有効にして、Db2 ODBC 診断トレースによって収集されるトレース・レコードを制限します。このキーワードは、DIAGTRACE キーワードを使用してトレースを開始した場合に限り、 使用してください。
トレース・マスクは、ピリオドで区切られた 5 つのパートから構成されます。
- タイプ
- 製品
- コンポーネント
- 関数
- カテゴリー
各パートには、コンマ区切りのリスト、ハイフン区切りの範囲、または単一の項目を指定できます。デフォルトの設定値 DIAGTRACE_MASK=*.*.*.*.* は、 すべてのトレース・レコードをキャプチャーします。特定のレコードをキャプチャーするには、 トレースする特定のタイプ、製品、コンポーネント、関数、およびカテゴリー (またはカテゴリー) に対応する番号を、 マスクに設定します。コンポーネント 41 に関する入り口レコードと出口レコードをすべてトレースするには、 DIAGTRACE_MASK=1,2.*.41.*.* と設定します。 ここで 41 は、コンポーネントを指定し、1 および 2 は、トレースを入り口および出口のレコードのみに制限することを指定しています。
トレース・マスクは、IBM のデバッグ用に、 トレースをアクティブ化するために用意されています。
EXTENDEDTABLEINFO = 0 | 1
このキーワードは、データ・ソース・セクションに置かれます。EXTENDEDTABLEINFO キーワードは、拡張表タイプが SQLTables() 関数呼び出しから返されるかどうかに関する情報を指定します。 現在、1 つの拡張表タイプ ACCEL-ONLY TABLE があります。
可能な値は、以下のとおりです。
- 0
- SQLTables() 関数によって返される結果セットには、拡張表タイプの列は含まれていません。
拡張表タイプの行は、SQLTables() 呼び出しの szTableType パラメーター値、 または TABLETYPE 初期化キーワードで "TABLE" が明示的に指定されている場合にのみ返されます (szTableType が NULL ポインターの場合)。 この場合、拡張表タイプは結果セットの TABLE_TYPE 列に TABLE としてリストされます。
- 1
- SQLTables() 関数によって返される結果セットには、拡張表タイプの行と列が含まれています。
具体的には、次のようになります。
- 結果セットには、SQLTables() からの結果セットに常に返される列の後に、追加列 TEMPORAL_TABLE_TYPE、 IS_ACCELERATED、 ACCEL_ARCHIVE_STATUS、および IS_ARCHIVE_ENABLED が入ります。 それらの列の説明については、SQLTables() - 表情報を取得するを参照してください。
- 拡張表タイプの行は、以下の状況の場合に返されます。
- すべての表タイプは、SQLTables() 呼び出しの szTableType パラメーターに NULL ポインターを指定することにより、暗黙的に要求されます (TABLETYPE 初期化キーワードの指定ではない)。
- 拡張表タイプ名は SQLTables() 呼び出しの szTableType パラメーター、または TABLETYPE 初期化キーワードで明示的に指定されます。
この場合、拡張表タイプは、結果セットの TABLE_TYPE 列にその拡張表タイプ名でリストされます。

- GRANTEELIST = userID1, userID2, ... userIDn
このキーワードは、データ・ソース・セクションに置かれます。
GRANTEELIST キーワードを使用すると、 表に関する権限リスト、または表の列に関する権限リストをアプリケーションで取得する場合に、 返される情報量を減らすことができます。指定された許可 ID のリストが、 フィルターとして使用されます。特定の表に関する権限リストをアプリケーションが取得すると、指定されたユーザー ID に権限付与されている列のみが返されます。
このキーワードは、 API SQLColumnPrivileges および SQLTablePrivileges に適用されます。
- GRANTORLIST = userID1, userID2, ... userIDn
このキーワードは、データ・ソース・セクションに置かれます。
GRANTORLIST キーワードを使用すると、表に関する権限リスト、または表の列に関する権限リストをアプリケーションで取得する場合に返される情報量を減らすことができます。指定された許可 ID のリストが、 フィルターとして使用されます。特定の表に関する権限リストをアプリケーションが取得すると、指定されたユーザー ID によって付与された権限を持つ列のみが返されます。
このキーワードは、 API SQLColumnPrivileges および SQLTablePrivileges に適用されます。
- GRAPHIC =0 | 1 | 2 | 3
- このキーワードは、データ・ソース・セクションに置かれます。GRAPHIC キーワードは、SQLGetTypeInfo() が呼び出されたときに、サポートされているデータ・タイプの 1 つとして IBM GRAPHIC (2 バイト文字 サポート) を Db2 ODBC が報告するかどうかを制御します。 SQLGetTypeInfo() は、データ・ソースが現行接続用にサポートしている データ・タイプをリストします。これらのデータ・タイプは ODBC 固有のタイプではありませんが、Db2 ファミリー製品に接続されているアプリケーションに対して これらのタイプを明らかにするために追加されました。
- 0
- 無効 (デフォルト)
- 1
- 有効
- 2
- DESCRIBE によって戻されるグラフィック列の長さを、DBCS 文字数ではなくバイト数で報告します。これは、出力引数かまたは結果セットの一部として長さまたは精度を戻す、 すべての Db2 ODBC および ODBC 関数に適用されます。
- 3
- 1 と 2 の設定を組み合わせたもの、つまり、GRAPHIC=3 は、1 と 2 の効果が組み合わせられたものになります。
デフォルトでは、GRAPHIC は戻されません。その理由は、アプリケーションの多くがこのデータ・タイプを認識せず、 適切に処理できないからです。
- INTERRUPT = 0 | 1 | 2
- INTERRUPT キーワードを使用すると、ステートメントの処理をキャンセルするために SQLCancel() が呼び出されたときの割り込み処理モードを指定することができます。
- 0
- 割り込み処理を使用不可にします (SQLCancel 呼び出しによる処理への割り込みはありません)。
- 1
- 割り込みがサポートされます (デフォルト)。 このモードでは、サーバーで接続に対して割り込みがサポートされている場合に、割り込みが送信されます。 サポートされていない場合は、接続はドロップされます。
- 3
- サーバーの割り込み機能に関係なく、割り込みによって接続はドロップされます (SQLCancel() によって接続がドロップされます)。
このキーワードは、初期設定ファイルで MVSATTACHTYPE=RRSAF が指定されているアプリケーションにのみ適用されます。 RRSAF 接続機能を通じて確立された接続のみをドロップできます。
INTERRUPT を 1 に設定すると、Db2 ODBC はステートメントに関連付けられた接続を常にドロップします。
- LIMITEDBLOCKFETCH = 0 | 1
- このキーワードは、データ・ソース・セクションに置かれます。
LIMITEDBLOCKFETCH は、Db2 ODBC が接続されたデータ・ソースから結果セットをフェッチする場合に、限定ブロック・フェッチの使用を試みるかどうかを指定します。 限定ブロック・フェッチは、SQL 照会によって取得される行を照会バッファー内の行のブロックにグループ化することによって、データ取得のために Db2 サーバーとやり取りする回数を大幅に減らすことができます。 限定ブロック・フェッチは、ローカル Db2 サーバーから前方スクロール・カーソルを使用して大量の読み取り専用の結果セットを取得する Db2 ODBC アプリケーションにメリットがあります。 LIMITEDBLOCKFETCH は、SQLFetch()、SQLExtendedFetch()、および SQLFetchScroll() の関数によって実行される FETCH 操作に影響を与えます。 可能な値は、以下のとおりです。
- 0
- 限定ブロック・フェッチは使用されません。
- 1
- Db2 ODBC は限定ブロック・フェッチの使用を試みます。
フェッチ中の結果セットに対してサーバーでブロッキングがサポートされている場合、Db2 ODBC は単一のフェッチ要求で照会データ・ブロックに収まるだけの行を取得します。
1 がデフォルトです。
限定ブロック・フェッチを使用可能にする場合、QUERYDATASIZE 初期化パラメーターを設定することで、照会データ・ブロックのサイズを設定することもできます。
LIMITEDBLOCKFETCH=1 を指定すると、指定しなければ Db2 ODBC で使用される、Db2 の複数行フェッチなどの代替フェッチ最適化がオフになります。
Db2 ODBC の限定ブロック・フェッチは、次の場合にはサポートされません。
- リモート・データ・ソースに接続する場合
- 読み取り専用結果セット以外の結果セットの場合
- SQL_CURSOR_FORWARD_ONLY 以外のカーソル・タイプの場合
結果セット内のいずれかの列がファイル参照変数の場合
- アプリケーションがステートメント属性 SQL_NODESCRIBE を SQL_NODESCRIBE_ON に設定し、SQLSetColAttributes() を使用して結果セット列のデータ・ソース結果記述子を設定する場合
サポートされていない状況で限定ブロック・フェッチを使用可能にすると、パフォーマンスに影響を与える場合があります。
関連情報:
- LITERALREPLACEMENT = 0 | 1
- このキーワードは、データ・ソース・セクションに置かれます。
LITERALREPLACEMENT キーワードは、リテラルを含む動的 SQL ステートメントを、リテラル定数でキャッシュするのか、リテラル定数の置換マーカーでキャッシュするのかを指定します。 デフォルト値は 0 です。
- 0
- ステートメントはリテラル定数でキャッシュされます。 同じ動的ステートメントのキャッシュ済みバージョンとは異なる 1 つ以上の定数がステートメントに含まれる場合、そのステートメントは固有のステートメント項目としてキャッシュされます。
- 1
- ステートメントはリテラル定数の置換マーカーでキャッシュされます。
当該ステートメントが以下の基準も満たす場合、Db2 は、リテラル定数以外は同じである動的ステートメントのキャッシュ項目を共用できます。
- ステートメントにパラメーター・マーカーが含まれない。
- 新規ステートメントの定数を、キャッシュ済みステートメントの定数の代わりに再利用できる。
- ステートメントが、動的ステートメント・キャッシュ共用の他の条件をすべて満たしている。
- MAXCONN = 0 | positive number
- このキーワードは、共通セクションに置かれます。
MAXCONN キーワードを使用して、それぞれの Db2 ODBC アプリケーション・プログラムごとに可能な最大接続数を指定します。システム管理者は、各アプリケーションが確立する最大接続数の管理プログラムとしてこのキーワードを使用できます。
- 0
- 制限なし を表すために使用できます。 つまり、アプリケーションは、システム・リソースで許されるだけの数の接続をオープンすることができます。 これはデフォルトです。
- 正数
- それぞれのアプリケーションがオープンできる最大接続数を指定するには、任意の正数をキーワードに設定します。
このパラメーターは、アプリケーションが正常に出すことができ る SQLConnect() ステートメントの数を制限します。 さらに、アプリケーションが CONNECT (タイプ 1) の 意味をもって実行されている場合、この値は論理接続の数を指定します。 ローカル Db2 またはリモート Db2 サブシステム、 あるいはリモート DRDA-1 または DRDA-2 サーバーのいずれかへの物理接続は一度に1 つのみです。
- MULTICONTEXT = 0 | 1 | 2
- このキーワードは、共通セクションに置かれます。
MULTICONTEXT キーワードは、アプリケーションでのそれぞれの接続を、他の接続とは独立のそれ自体のコミット範囲で、別個の作業単位として扱えるかどうかを制御します。
- 0
- Db2 ODBC コードは、データ・ソース接続用に独立したコンテキスト は作成しません。現行接続での現行トランザクションが (コミットまたはロールバックにより) トランザクション境界上にないかぎり、CONNECTTYPE=1 の規則によって制御される複数データ・ソース間で、接続を切り替えることはできません。これはデフォルトです。
ODBC アプリケーションが z/OS コンテキスト・サービスを使用して、それ自体のコンテキストを作成および管理できるようにするには、MULTICONTEXT=0 および MVSATTACHTYPE=RRSAF を指定してください。 このようなサービスを用いると、アプリケーションはそれ自体のコンテキストを、ODBC 外部で、 それぞれのコンテキストが独立した作業単位として作動するように、管理することができます。
アプリケーションが Db2 ODBC ストアード・プロシージャーとして実行している 場合は、Db2 ODBC の外部コンテキストのサポートは使用できません。
アプリケーションでグローバル・トランザクション処理を使用可能にする場合 は、AUTOCOMMIT=0, MULTICONTEXT=0、および MVSATTACHTYPE=RRSAF を 指定します。
- 1
- Db2 ODBC コードは、SQLAllocHandle() が出されると、接続ハンドル・レベルでデータ・ソース接続の独立コンテキストを作成します。複数のデータ・ソースに対するそれぞれの接続は、CONNECTTYPE=1 の規則によって制御され、独立した Db2 スレッドと関連付けられます。複数のデータ・ソース間の接続切り替えが、トランザクションのコミット状況のために妨げられることはありません。
アプリケーションは、ある接続上でコミットまたはロールバックを行わなくても、別の接続ハンドルへ切り替える前に、複数の接続ハンドルを使用できます。
Db2 ODBC および組み込み SQL を含むアプリケーションでは MULTICONTEXT=1 はサポートされません。
- 2
- MULTICONTEXT=2 および MULTICONTEXT=1 は、接続特性を共用します。
ただし、MULTICONTEXT=2 が指定されると、Db2 ODBC は、複数コンテキスト環境の指定された言語処理環境®スレッド下で、マルチスレッド・アプリケーションがアクティブ環境ハンドルを常に保守できるようにします。
MULTICONTEXT=1 に適用される制限はすべて MULTICONTEXT=2 にも適用されます。
重要: MULTICONTEXT=2 は、IBM ソフトウェア・サポートの指示がある場合にのみ使用してください。 MULTICONTEXT=2 の乱用は、アプリケーションが異常終了する原因になり得ます。
アプリケーションは、InfoType を SQL_MULTIPLE_ACTIVE_TXN に設定した SQLGetInfo() を使用して、MULTICONTEXT=1 または MULTICONTEXT=2 がサポートされているかどうかを判別することができます。
次のいずれかの条件が当てはまる場合には、MULTICONTEXT=1 および MULTICONTEXT=2 は無視されます。
- Db2 ODBC を呼び出す前に、アプリケーションは Db2 スレッドを作成した。 この状態では、Db2 ODBC を使用するストアード・プロシージャーの場合は常に該当します。
- アプリケーションは、Db2 ODBC を呼び出す前に、z/OS コンテキスト・サービスを使用してプライベート・コンテキストを作成し、それに切り替えた。
- アプリケーションは、Db2 ODBC を呼び出す前に、RRS リソース・マネージャー (例えば、IMS™) を使用してリカバリー単位を開始した。
- MVSATTACHTYPE=CAF が初期化ファイルに指定されている。
- オペレーティング・システム・レベルが、無許可コンテキスト・サービスをサポートしていない場合。
- MVSATTACHTYPE = CAF | RRSAF
- このキーワードは、サブシステム・セクションに置かれます。
MVSATTACHTYPE キーワードを使用して、Db2 ODBC が Db2 for z/OS アドレス・スペースを 接続するために使用する Db2 for z/OS 接続タイプを指定します。Db2 ODBC アプリケーション が Db2 for z/OS ODBC ストアード・プロシージャーとして実行されている場合、このパラメーターは無視されます。 この場合、Db2 ODBC は、ストアード・プロシージャー用に定義された次の接続タイプを使用します。
- CAF
- Db2 ODBC は、Db2 for z/OS 呼び出し接続機能 (CAF) を使用します。 CAF がデフォルト値です。
- RRSAF
- Db2 ODBC は、Db2 for z/OS リソース・リカバリー・サービス接続機能 (RRSAF) を使用します。
z/OS コンテキスト・サービスを使用して、ODBC アプリケーションがそれ自体のコンテキストを作成し、管理できるようにするには、MVSATTACHTYPE=RRSAF および MULTICONTEXT=0 を指定してください。詳細については、MULTICONTEXT = 0 | 1 | 2を参照してください。
グローバル接続でのトランザクションの場合は、AUTOCOMMIT=0, MULTICONTEXT=0、 および MVSATTACHTYPE=RRSAF を指定してグローバル・トランザクション処理を 完了してください。
アプリケーションでグローバル・トランザクション処理を使用可能にするに は、MVSATTACHTYPE=RRSAF、AUTOCOMMIT=0、および MULTICONTEXT=0 を 指定します。
- MVSDEFAULTSSID = ssid
- このキーワードは、共通セクションに置かれます。
MVSDEFAULTSSID キーワードは、SQLAllocHandle 関数 (HandleType を SQL_HANDLE_ENV に設定) を呼び出すときにアプリケーションが接続される、デフォルトの Db2 サブシステムを指定します。 接続先の Db2 サブシステム名、サブグループ接続名、またはグループ接続名 (データ共有グループで使用する場合) を指定します。デフォルトのサブシステム名は「DSN」です。
- OPTIMIZEFORNROWS = integer
- このキーワードは、データ・ソース・セクションに置かれます。
OPTIMIZEFORNROWS キーワードは、"OPTIMIZE FOR n ROWS" 文節を すべての SELECT ステートメントに付加します (ただし、n は、0 より 大きい整数です)。デフォルトのアクションでは、この文節を追加しません。
- PARAMOPTATOMIC = 0 | 1
- このキーワードは、データ・ソース・セクションに置かれます。
PARAMOPTATOMIC キーワードは、複数行の挿入の下層処理がアトミック SQL または非アトミック SQL のどちらで行われるかを決定します。PARAMOPTATOMIC には、以下の値が入ります。
- 0
- 下層処理は非アトミック SQL を使用します。
- 1
- 下層処理はアトミック SQL を使用します。これはデフォルトです。
- PATCH2 = patch number
- このキーワードは、データ・ソース・セクションに置かれます。PATCH2 キーワードは、ODBC アプリケーションの既知の問題に対しての予備手段を指定します。複数の PATCH2 値を設定する場合は、値をコンマで区切って順にリストします。 例えば、パッチ 300、301、302 を指定するには、 初期化ファイルに PATCH2= "300,301,302" と指定します。PATCH2 キーワードに有効な値は、次のとおりです。
- 0
- 予備手段なし (デフォルト)。
- 300
- SQLExecute() および SQLExecDirect() は、SQLCODE=100 の場合に SQL_SUCCESS ではなく SQL_NO_DATA_FOUND を返します。 この場合、削除または更新の影響を受ける行はなく、 また INSERT ステートメントの副選択の結果は何もありません。
301
SQLError() および SQLGetDiagRec() は、同じステートメント・ハンドルで SQLExecute()、SQLExecDirect()、SQLFetch()、SQLExtendedFetch()、または SQLFetchScroll() を以前に呼び出して SQL_NO_DATA_FOUND (SQLCODE=100) が返されていた場合に、追加の診断情報を返します。
- 0: 予備手段なし (デフォルト)。
- 300
PATCH2=300 の性質: SQLExecute() および SQLExecDirect() は、SQLCODE=100 の場合、SQL_SUCCESS ではなく SQL_NO_DATA_FOUND を戻します。この場合、削除または更新の影響を受ける行はなく、 また INSERT ステートメントの副選択の結果は何もありません。
次の表では、PATCH2 の設定が戻りコードに どのように影響するかを説明しています。表 1. PATCH2 の設定と SQL 戻りコード SQL ステートメント SQLExecute() および SQLExecDirect() 戻り値 検索 UPDATE または検索 DELETE であり、 検索条件を満たす行がない場合 - パッチがなければ (PATCH2=0)、SQL_SUCCESS
- パッチがあれば (PATCH2=300)、 SQL_NO_DATA_FOUND
一括 DELETE または一括 UPDATE であり、 検索条件を満たす行がない場合 - パッチがなければ (PATCH2=0)、 SQL_SUCCESS_WITH_INFO
- パッチがあれば (PATCH2=300)、 SQL_NO_DATA_FOUND
一括 DELETE または一括 UPDATE であり、 検索条件を満たす行が 1 つ以上存在する場合 パッチがない (PATCH2=0) 場合、またはパッチがある (PATCH2=300) 場合 、SQL_SUCCESS_WITH_INFO ODBC 3.0 では、アプリケーションはパッチをオンにする必要はありません。 ODBC 3.0 の性質は、PATCH2=300 に設定したのと同じです。
- PLANNAME = planname
- このキーワードは、サブシステム・セクションに置かれます。
PLANNAME キーワードは、インストールの間に作成さ れた Db2 for z/OS PLAN の名前を指定します。PLAN 名は、Db2 for z/OS サブシステムへのアプリケーション接続の初期化時に必要になります。この状況は、SQLAllocHandle() 呼び出し (HandleType を SQL_HANDLE_ENV に設定) の処理の間に起こります。
PLANNAME を指定しなければ、デフォルト値の DSNACLI が使用されます。
- QUERYDATASIZE = integer
- このキーワードは、データ・ソース・セクションに置かれます。
QUERYDATASIZE は、限定ブロック・フェッチが使用可能の場合に、各 FETCH 操作で Db2 が返す照会データの量をバイト数で指定します。 QUERYDATASIZE 値は、限定ブロック・フェッチを最適化するために使用できます。 これは、データの検索に必要なデータ・ソースへの往復の数を制御します。
QUERYDATASIZE に大きい値を使用すると、パフォーマンスが向上する場合があります。 例えば、結果セットのサイズが 50 KB であり、QUERYDATASIZE の値が 32767 (32 KB) の場合、結果セットを検索するにはデータ・ソースへの 2 回の往復が必要です。しかし、QUERYDATASIZE が 65535 (62 KB) の場合は、結果セットを検索するために必要なデータ・ソースへの往復は 1 回だけです。
- 整数
- 以下のいずれかの QUERYDATASIZE 値になります。
- 32767
- 65535
- 98303
- 131071
- 163839
- 196607
- 229375
- 262143
- 294911
- 327679
- 360447
- 393215
- 425983
- 458751
- 491519
- 524287
- 557055
- 589823
- 622591
- 655359
- 688127
- 720895
- 753663
- 786431
- 819199
- 851967
- 884735
- 917503
- 950271
- 983039
- 1015807
- 1048575
デフォルトは 32767 です。
有効ではない値を指定すると、Db2 ODBC は QUERYDATASIZE を最も近い有効値に設定します。
- RETURNALIASES = 0 | 1
このキーワードは、データ・ソース・セクションに置かれます。
RETURNALIASES キーワードは、メタデータ・プロシージャーで行を修飾するときに、 別名を含めるかどうかを指定します。別名を対象外として、行を修飾しない場合、 基本表とのコストの高い結合が回避されるため、パフォーマンスを高めることができます。
- 0
- メタデータ・プロシージャーに対して行が適格な場合、別名は考慮されません
- 1
- メタデータ・プロシージャーに対して行が適格な場合、別名が考慮されます
このキーワードは、次の ODBC API に影響を与えます。
- SQLColumns()
- SQLColumnPrivileges()
- SQLTables()
- SQLTablePrivileges()
- SQLStatistics()
- SQLSpecialColumns()
- SQLForeignKeys()
- SQLPrimaryKeys()
- RETCATALOGASCURRSERVER = 0 | 1
このキーワードは、データ・ソース・セクションに置かれます。
RETCATALOGASCURRSERVER キーワードを使用すると、 カタログ列のヌル値の代わりに CURRENT SERVER 値を返すように DBMS に指定できます。
- 0
- カタログ関数は、カタログ列のヌル値を返します。
- 1
- カタログ関数は、カタログ列のヌル値の代わりに CURRENT SERVER 値を返します。
このキーワードは、次の ODBC API に影響を与えます。
- SQLColumns()
- SQLColumnPrivileges()
- SQLTables()
- SQLTablePrivileges()
- SQLStatistics()
- SQLSpecialColumns()
- SQLForeignKeys()
- SQLPrimaryKeys()
- SQLProcedures()
- SQlProcedureColumns()
- RETURNSYSNONYMSCHEMA = 0 | 1
このキーワードは、データ・ソース・セクションに置かれます。
RETURNSYSNONYMSCHEMA は、カタログ API が TABLE_SCHEM 列にあるシノニムのスキーマ名をレポートするかどうかを制御します。
- 0
- カタログ関数は、スキーマ列として NULL を返します。
- 1
- カタログ関数は、スキーマ列としてシノニムの作成者を返します。
このキーワードは、次の ODBC API に影響を与えます。
- SQLColumns()
- SQLColumnPrivileges()
- SQLTables()
- SQLTablePrivileges()
- SQLStatistics()
- SQLSpecialColumns()
- SQLForeignKeys()
- SQLPrimaryKeys()
- SCHEMALIST = "'schema1', 'schema2' ,…"
- このキーワードは、データ・ソース・セクションに置かれます。
SCHEMALIST キーワードは、データ・ソース内のスキーマのリストを指定します。
データベースに多数の表がある場合、スキーマ・リストを指定して、アプリケーションが表情報を照会するのにかかる時間とアプリケーションがリストする表の数を削減することができます。 各スキーマ名は、大文字と小文字が区別され、単一引用符で囲み、コンマで区切る必要があります。ストリング全体も二重引用符で囲む必要があります。例えば次のとおりです。SCHEMALIST="'USER1','USER2',USER3'"Db2 for z/OS ODBC の場合、CURRENT SQLID もこのリストに加えることができますが、単一引用符は使用しません。例えば次のとおりです。SCHEMALIST="'USER1',CURRENT SQLID,'USER3'"キーワード・ストリングの最大長は、2048 文字です。
このキーワードを DBNAME および TABLETYPE と使用して、情報が戻される表の数をさらに制限することができます。
常にデータベース・サーバー内のすべての表をリストするようなアプリケーションでは、SCHEMALIST を 使用してさらに制限されたデフォルトを指定します。これによって、 少数のスキーマにある表のみを参照する場合は、表リストを取り出す際のパフォーマンスが向上します。
STREAMBUFFERSIZE
このキーワードは、データ・ソース・セクションに置かれます。STREAMBUFFERSIZE は、限定ブロック・フェッチが使用可能の場合 (LIMITEDBLOCKFETCH = 1) にのみ有効です。 STREAMBUFFERSIZE は、LOB データまたは XML データが、インライン・データとして全体性を保って返されるか、またはプログレッシブ参照と呼ばれる内部トークンとして返されるかを決定するのに使用されるしきい値を、バイト単位で指定します。- LOB オブジェクトまたは XML オブジェクトが STREAMBUFFERSIZE 値以下である場合、データ値は、照会ブロック内の行の一部としてインラインで返されます。 データ値は、後続処理のために ODBC ドライバーでキャッシュされます。
- LOB オブジェクトまたは XML オブジェクトのサイズが STREAMBUFFERSIZE より大きい場合、データ値はプログレッシブ参照として返されます。
STREAMBUFFERSIZE のデフォルト値は 1,048,576 バイト、つまり 1 MB です。

- SYSSCHEMA = sysschema
- このキーワードは、データ・ソース・セクションに置かれます。sysschema で指定する値は、128 バイトを超えてはなりません。
SYSSCHEMA キーワードは、Db2 ODBC および ODBC カタログ関数呼び出しが出されて カタログ情報を取得する際に、SYSIBM (または SYSTEM、QSYS2) スキーマの代わりに 検索される代替スキーマを示しています。
システム管理者は、このスキーマ名を使用して、次の各 Db2 カタログ表ごとに、 複数行の一部から構成された 1 セットのビューを定義することができます。
- SYSCOLAUTH
- SYSCOLUMNS
- SYSDATABASE
- SYSFOREIGNKEYS
- SYSINDEXES
- SYSKEYS
- SYSPARMS
- SYSRELS
- SYSROUTINES
- SYSSYNONYMS
- SYSTABAUTH
- SYSTABLES
例えば、カタログ表のビューのセットが ACME スキーマにある 場合は、SYSIBM.SYSTABLES のビューは ACME.SYSTABLES です。 さらに SYSSCHEMA は、ACME に設定する必要があります。
カタログ表の限定されたビューを定義し、使用すると、アプリケーションがリスト する表の数が減るため、アプリケーションが表情報を照会するのにかかる時間が削減されます。
値を指定しない場合、以下のデフォルト値が使用されます。- Db2 for z/OS では、SYSIBM
- DB2® for VSE & VM では SYSTEM
- DB2 for i では QSYS2
- TABLETYPE="'TABLE' | ,'ALIAS' | ,'VIEW' | , 'SYSTEM TABLE' | ,'SYNONYM' | 'GLOBAL TEMPORARY TABLE' |, 'AUXILIARY TABLE' |, 'MATERIALIZED QUERY TABLE' |, 'ACCEL-ONLY TABLE'"
- このキーワードは、データ・ソース・セクションに置かれます。
TABLETYPE キーワード は、1 つ以上の表タイプのリストを指定します。データ・ソースに多数の表が定義されている場合、表タイプ・ストリングを指定して、アプリケーションが表情報を照会するのにかかる時間とアプリケーションがリストする表の数を削減することができます。
任意の個数の値を指定できますが、それぞれのタイプは、単一引用符で囲み、コンマで区切り、大文字でなければなりません。ストリング全体も二重引用符で囲む必要があります。例えば次のとおりです。
このキーワードを DBNAME および SCHEMALIST と使用して、情報が戻される表の数をさらに制限することができます。TABLETYPE="'TABLE','VIEW'"TABLETYPE を使用して、SQLTables() 呼び出しにデフォルトを与えます。 これは、データ・ソースの表名および関連づけられている情報のリストを取り出します。 アプリケーションが関数呼び出しの際に表タイプを指定せず、かつ、 このキーワードが使用されていない場合は、すべての表タイプについての情報が戻されます。 このアプリケーションが、関数呼び出しの際に、szTableType 引数 に値を指定した場合は、その引数の値は当キーワード値をオーバーライドします。
TABLETYPE が、TABLE 以外の値を持つ場合には、DBNAME キーワードの設定を使用して、情報を特定の Db2 for z/OS サブシステムに制限することはできません。
'ACCEL-ONLY TABLE' は拡張表タイプの名前です。 EXTENDEDTABLETYPE 初期化パラメーターが 1 に設定されている場合にのみ、SQLTables() 呼び出しの結果セットに拡張表タイプ名が返されます。
- THREADSAFE= 1 | 0
- このキーワードは、共通セクションに置かれます。
THREADSAFE キーワードは、複数の並行または並列の言語処理環境のスレッドに対応して Db2 ODBC コードをスレッド・セーフ にするために、Db2 ODBC が POSIX mutexes を使用するかどうかを制御します。
- 1
- アプリケーションが POSIX(ON) の環境で実行されている場合、Db2 ODBC コードはスレッド・セーフになります。 プロセスの複数の言語処理環境のスレッドが Db2 ODBC を使用できます。スレッド・セーフ機能は、POSIX(OFF) の環境では提供できません。 1 がデフォルト値です。
- 0
- Db2 ODBC コードは、スレッド・セーフではありません。 この設定によって、非マルチスレッド・アプリケーションの Db2 ODBC でのシリアライズされたコードのコストが削減されますが、マルチスレッドのアプリケーションでの並行する言語処理環境のスレッドの保護は提供されません。
- TRACEPIDTID = 0 | 1
- このキーワードは、共通セクションに置かれます。
TRACEPIDTID は、トレースが APPLTRACE キーワードによって開始された場合のみ使用されます。TRACEPIDTID を 1 に設定すると、 プロセス ID およびスレッド ID が、 トレース出力の各行の先頭に追加されます。これらの ID は、 Db2 ODBC アプリケーションが 複数の言語処理環境スレッドを 1 つの POSIX(ON) 環境内で同時実行している場合に、 記録された情報をプロセスおよびスレッドによって区別するのに役立ちます。
- TRACECTXTOKEN = 0 | 1
- このキーワードは、共通セクションに置かれます。
TRACECTXTOKEN は、トレースが APPLTRACE キーワードによって開始された場合のみ使用されます。TRACECTXTOKEN を 1 に設定すると、 RRS コンテキスト・トークンがトレース出力にキャプチャーされます。 RSS コンテキスト・トークンは、 さまざまな RRS コンテキストで実行されるアプリケーションの実行パスを判別するのに役立ちます。
このキーワードは、 初期設定ファイルにキーワード MVSATTACHTYPE=RRSAF および MULTICONTEXT=0 を指定している場合に、 z/OS Resource Recovery Services を使用して専用の RRS コンテキストを作成および管理する アプリケーションにのみ適用されます。
- TRACETIMESTAMP = 0 | 3
- このキーワードは、共通セクションに置かれます。
TRACETIMESTAMP は、トレースが APPLTRACE キーワードによって開始された場合のみ使用されます。 APPLTRACE を 1 に設定した場合は、TRACETIMESTAMP キーワードを使用すると、Db2 ODBC アプリケーション・トレースにさまざまなタイプのタイム・スタンプ情報が取り込まれます。
- 0
- タイム・スタンプ情報をトレース出力に書き込みません。
- 3
- トレース出力の各行の先頭に ISO タイム・スタンプを追加します。
- TXNISOLATION = 1 | 2 | 4 | 8 | 32
- このキーワードは、データ・ソース・セクションに置かれます。
TXNISOLATION キーワードは、分離レベルを以下のいずれかの値に設定します。
- 1
- 非コミットでの読み取り (非コミット読み取り)
- 2
- コミットでの読み取り (カーソル固定) (デフォルト)
- 4
- 反復可能読み取り (読み取り固定)
- 8
- シリアライズ可能 (反復可能読み取り)
- 32
- (コミットなし、DB2 for i のみ)
大括弧内の語は、SQL92 分離レベルに相当する Db2 での用語です。 「コミットなし」は、SQL92 分離レベルではなく、DB2 for i のみでサポートされます。
- UNDERSCORE = 1 | 0
- このキーワードは、データ・ソース・セクションに置かれます。下線文字 (_) を、ワイルドカード (文字がない場合も含めて、いずれの文字にも一致する) 文字として使用するか、またはその文字自体として使用するかを指定します。このパラメーターは、検索パターン・ストリングを受け入れるカタログ関数呼び出しにのみ影響します。 UNDERSCORE キーワードは、次の値に設定することができます。
- 1
- 下線文字 (_) はワイルドカードの役割を果たします (デフォルト)。
下線は、任意の 1 文字または 0 文字に相当するワイルドカードとして扱われます。
例えば、2 つの表が以下のように定義されているとします。
上記の例で、SQLTables() (表情報を戻す Db2 ODBC カタログ関数呼び出し) は、 表名検索パターン引数に "KEY_WORDS" が指定されていると、"KEY_WORDS" および "KEYWORDS" の 両方の項目を戻します。CREATE TABLE "OWNER"."KEY_WORDS" (COL1 INT) CREATE TABLE "OWNER"."KEYWORDS" (COL1 INT) - 0
- 下線文字 (_) は、それ自体の役割を果たします。 下線は下線文字そのものとして扱われます。2 つの表が上記の例のように定義されている場合、表名検索パターン引数に "KEY_WORDS" を指定すると、SQLTables() は "KEY_WORDS" 項目のみを戻します。このキーワードを 0 に設定すると、結果として、データ・ソースの オブジェクト名 (所有者、表、列) が下線を含む場合に、パフォーマンスが改善されます。