接続属性 (CLI) リスト

• SQL_MODE_READ_ONLY: アプリケーションがデータに対して読み取り操作を行うように意図されていることを示します。そのため、トランザクションには、制限の少ない分離レベル、および非コミット読み取り (SQL_TXN_READ_UNCOMMITTED) などのロッキングを使用できます。CLI ドライバーは、データベースに対する要求が読み取り専用 であることを確認しません。 更新要求が出されると、CLI ドライバーは、SQL_MODE_READ_ONLY 設定値の結果として選択されたトランザクション分離レベルを使用して、更新要求を処理します。
• SQL_MODE_READ_WRITE (デフォルト): アプリケーションがデータを変更するように意図されていることを示します。CLI ドライバーは、SQL_MODE_READ_WRITE 属性が指定された接続のデフォルトのトランザクション分離レベルを使用します。

SQL_ATTR_ACCESS_MODE 属性が指定された接続には、未解決のトランザクションがあってはなりません。

アプリケーションが、Dynamic Data Format をサポートするデータ・サーバーを照会するときに、以前にアクセスした LOB 列に対してSQLGetData()関数を呼び出し、SQLGetData() 関数の以前の呼び出し時のデータ・オフセット位置を維持できるかどうかを指定します。

• SQL_ALLOW_INTERLEAVED_GETDATA_OFF (デフォルト): アプリケーションが以前にアクセスした LOB 列に対してSQLGetData()関数を呼び出すように意図されていないことを示します。
• SQL_ALLOW_INTERLEAVED_GETDATA_ON: アプリケーションが以前にアクセスした LOB 列に対してSQLGetData()を呼び出し、以前の読み取り時に読み取りを停止した位置から LOB データの読み取りを開始するように意図されていることを示します。

SQL_ATTR_ALLOW_INTERLEAVED_GETDATA 属性を指定する代わりに、AllowInterleavedGetData CLI/ODBC 構成キーワードを指定することもできます。

• SQL_AA_TRUE (デフォルト): アプリケーションが ANSI アプリケーションであることを示します。ANSI バージョンの CLI/ODBC 関数が使用されたときにアプリケーションとの間で受け渡される文字データはすべてクライアント・ページ・コードです。
• SQL_AA_FALSE: アプリケーションが Unicode アプリケーションであることを示します。Unicode (W) バージョンの CLI/ODBC 関数が呼び出されたときにアプリケーションとの間で受け渡される文字データはすべて Unicode です。

• 1 (デフォルト): LOB ロケーターを使用するように指定します。
• 0: LOB ロケーターを使用しないように指定します。 アプリケーションが、Dynamic Data Format フィーチャー (プログレッシブ・ストリーミングとも呼ばれる) をサポートするサーバーを照会する場合は、値 0 を指定すると、データをストリームでき、LOB ロケーターの使用を回避できます。

ストアード・プロシージャーの結果セットの場合は、SQL_ATTR_APP_USES_LOB_LOCATOR 属性が無視されます。

SQL_ATTR_APP_USES_LOB_LOCATOR 属性が 0 に設定された場合、アプリケーションがSQLBindCol()関数を使用して LOB ロケーターを結果セットにバインドすると、SQLFetch() 関数から、変換が無効であることを示すエラーが返されます。

LOB ロケーターが使用されることを示すために、代わりに AppUsesLOBLocator CLI/ODBC 構成キーワードを設定することもできます。

SQL_ATTR_APPEND_FOR_FETCH_ONLY 属性を使用すると、アプリケーションで、CLI ドライバーが "FOR FETCH ONLY" 節を追加するかどうかを指定できます。例えば、BLOCKING UNAMBIG オプションを指定して CLI パッケージをバインドする場合は、アプリケーションで SQL_ATTR_APPEND_FOR_FETCH_ONLY 属性に値 0 を指定するとカーソル・ブロッキングが行われず、値 1 を指定するとカーソル・ブロッキングが行われます。

SQL_ATTR_APPEND_FOR_FETCH_ONLY は、接続が割り振られる前、または接続の確立直後に、設定できます。アプリケーションは、接続が確立された後、または SQL_ATTR_APPEND_FOR_FETCH_ONLY 属性が設定された後、SQLGetConnectAttr() 関数を使用して SQL_ATTR_APPEND_FOR_FETCH_ONLY 属性を照会できます。

CLI ドライバーが "FOR FETCH ONLY" 節をいつ追加するかを指定するために、代わりに AppendForFetchOnly CLI/ODBC 構成キーワードを設定することもできます。

• SQL_ASYNC_ENABLE_OFF (デフォルト): 非同期のステートメント実行を使用不可にします。
• SQL_ASYNC_ENABLE_ON: 非同期のステートメント実行を使用可能にします。

この属性は、InfoType 引数の値 SQL_ASYNC_MODE が指定されて呼び出されたSQLGetInfo()関数が、SQL_AM_CONNECTION または SQL_AM_STATEMENT を返すときに設定できます。

• SQL_TRUE = SQLPrepare() 呼び出し後の IPD の自動移植がサーバーによりサポートされています。
• SQL_FALSE = SQLPrepare() 呼び出し後の IPD の自動移植はサーバーによりサポートされていません。準備状態のステートメントをサポートしないサーバーでは、 IPD を自動的に移植することはできません。

SQL_ATTR_AUTO_IPD 接続属性に SQL_TRUE が戻される場合は、 接続属性 SQL_ATTR_ENABLE_AUTO_IPD を設定して、 IPD 自動移植のオン/オフを切り換えることができます。 SQL_ATTR_AUTO_IPD が SQL_FALSE の場合、 SQL_ATTR_ENABLE_AUTO_IPD を SQL_TRUE に設定することはできません。

SQL_ATTR_ENABLE_AUTO_IPD のデフォルト値は、 SQL_ATTR_AUTO_IPD の値と等しくなります。

この接続属性は、SQLGetConnectAttr() によって戻せますが、 SQLSetConnectAttr() で設定することはできません。

• SQL_AUTOCOMMIT_OFF: 自動コミット・モードは無効です。 アプリケーションは、SQLEndTran() 関数呼び出しを使用して、トランザクションを明示的にコミットまたはロールバックする必要があります。
• SQL_AUTOCOMMIT_ON (デフォルト): 自動コミット・モードは有効です。 CLI ドライバーは、デフォルトでは自動コミット・モードで作動します。各 SQL ステートメントは、暗黙コミットされます。照会ではない各ステートメントは、ステートメントが正常に実行された直後にコミットされるか、障害が発生した場合にはロールバックされます。 各照会は、関連付けられているカーソルがクローズするとすぐにコミットされます。

  調整された分散作業単位 (XA) 接続の場合、 デフォルト値は SQL_AUTOCOMMIT_OFF になります。

• SQL_AUTOCOMMIT_DEFERRED: 自動コミット・モードは有効ですが、COMMIT ステートメントはすぐに送信されません。 自動コミット・モードは、後続の SQL ステートメントに対して有効です。SQL_AUTOCOMMIT_DEFERRED 値を設定すると、後続の SQL ステートメントのうち最初のものが現行トランザクションの一部として処理されます。

SQL_AUTOCOMMIT_ON 値が設定されると、すぐに CLI ドライバーが COMMIT ステートメントを発行し、後続の SQL ステートメントに対して自動コミット・モードが有効になります。 SQL_AUTOCOMMIT_ON を設定した各 SQL ステートメントの実行後に暗黙的な COMMIT ステートメントを別個にデータベース・サーバーに送信すると、アプリケーションのパフォーマンスに悪影響を与える可能性があります。

• SQL_ATTR_CACHE_USRLIBL_YES (デフォルト): *USRLIBL の値をキャッシュに入れるように指定します。サーバーから *USRLIBL の値が取得されると、同じ接続ハンドルのすべてのカタログ関数呼び出しに同じ *USRLIBL の値が使用されます。
• SQL_ATTR_CACHE_USRLIBL_NO: *USRLIBL の値をキャッシュに入れないように指定します。*USRLIBL の値をスキーマ・リストに指定すると、カタログ関数が呼び出されたときに必ず、現在の *USRLIBL の値が取得されます。カタログ関数を呼び出すときには必ず、データベース・サーバー上のメタデータ・プロシージャーを追加で呼び出す必要があります。
• SQL_ATTR_CACHE_USRLIBL_REFRESH: 現在キャッシュに入れられている *USRLIBL の値を削除するように指定します。これにより、カタログ関数の次回呼び出し時には、現在の *USRLIBL の値が取得され、キャッシュに入れられます。

SQL_ATTR_CACHE_USRLIBL 属性は、DB2 for i サーバーとともに使用する場合にのみ有効です。

例 1: このデータベース接続が使用するコード・ページを設定する

Unicode = 1208;
cliRC = SQLSetConnectAttr(hdbc,
                          SQL_ATTR_CLIENT_CODEPAGE, 
                          (SQLPOINTER)&unicode,  SQL_NTS);  
char *connStr = "DSN=EBCDICDB;"; 
cliRC = SQLDriverConnect (hdbc, (SQLHWND)NULL, connStr, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);

例 2: SQL_ATTR_CLIENT_CODEPAGE の現行値を取得する

cliRC = SQLConnect(hdbc,
                       (SQLCHAR *)"SAMPLE",
                        SQL_NTS,
                       (SQLCHAR *)"USER1",
                       SQL_NTS,
                       (SQLCHAR *)"PASSWD1",
                       SQL_NTS);

cliRC = SQLGetConnectAttr(hdbc, 
                      SQL_ATTR_CLIENT_CODEPAGE,
                      &codePage, 0, NULL);

• SQL_COLUMNWISE_MRI_OFF (デフォルト): CLI ドライバーは、チェーニング・データを列方向配列入力に変換しません。
• SQL_COLUMNWISE_MRI_ON: CLI ドライバーは、配列入力チェーニングを列方向配列入力に変換します。DB2 for z/OS の複数行挿入 (MRI) フィーチャーは、データが列方向配列の形式であることを想定します。アプリケーションが配列入力チェーニングを使用している場合、この変換によって、SQLExecute () を呼び出すたびにデータが圧縮された配列の形式で送信されるため、アプリケーションのパフォーマンスを最適化するのに役立ちます。 配列入力チェーニングについて詳しくは、SQL_ATTR_CHAINING_BEGIN を参照してください。

DB2 for z/OS サーバーで使用するために SQL_ATTR_COLUMNWISE_MRI 属性を指定できます。 DB2 for z/OS 以外のサーバーに対する接続では、CLI ドライバーがチェーニング・データを行方向配列入力に自動的に変換します。

• SQL_COMMITONEOF_ON: 結果セット全体および EOF マーカーが取得された後、COMMIT ステートメントを暗黙的に実行します。DB2 for z/OS バージョン 9 以降のサーバーに接続する場合にのみ、SQL_COMMITONEOF_ON の値がデフォルトになります。
• SQL_COMMITONEOF_OFF: 結果セット全体および EOF マーカーが取得された後、COMMIT ステートメントを暗黙的に実行しません。カーソルを閉じてリソースを解放するには、明示的に SQLFreeStmt() 関数を呼び出す必要があります。DB2 for z/OSバージョン 9 およびバージョン 9 以降のデータベース・サーバーに接続する場合を除き、SQL_COMMITONEOF_OFF の値がデフォルトになります。

• 0: 設定なし。クライアントは準備オプションを提供しません。
• 1: Currently Committed セマンティクスを使用します。 すべての準備ステートメントで、CLI ドライバーが Currently Committed セマンティクスを指定します。 この値は、データが更新または削除される際に、データベース・マネージャーが該当するスキャンに対してデータの現在コミット済みバージョンを使用することを意味します。 コミットされていない挿入行はスキップされます。 設定値 1 は、分離レベルがカーソル固定または読み取り固定の場合に適用され (読み取り固定の場合はコミットされていない挿入のみをスキップ)、それ以外の場合は無視されます。 該当するスキャンには、読み取り専用スキャン (読み取り専用ステートメントの一部、または読み取り専用ではないステートメントの一部である場合がある) が含まれます。レジストリー変数 DB2_EVALUNCOMMITTED、DB2_SKIPDELETED、および DB2_SKIPINSERTED の設定は、Currently Committed セマンティクスを使用するスキャンには適用されません。 ただし、これらのレジストリー変数の設定は、Currently Committed セマンティクスを使用しないスキャンには引き続き適用されます。
• 2: 結果を待機します。すべての準備ステートメントで、CLI ドライバーが wait for outcome 節を指定します。 カーソル固定以上の分離レベルのスキャンは、データが更新または削除される際に、コミットまたはロールバックを待機します。 挿入されている行はスキップされません。 レジストリー変数 DB2_EVALUNCOMMITTED、DB2_SKIPDELETED、および DB2_SKIPINSERTED の設定は、適用されなくなりました。
• 3: ロックされたデータをスキップします。すべての準備ステートメントで、CLI ドライバーが skip locked data 節を指定します。 Currently Committed セマンティクスが使用され、挿入されている行はスキップされます。 オプション 3 は、DB2 for Linux, UNIX, and Windows サーバーではサポートされません。 指定されていても、オプション 3 の設定は無視されます。

DB2 for Linux, UNIX, and Windows サーバーの場合、 SQL_ATTR_CONCURRENT_ACCESS_RESOLUTION 属性を使用して、cur_commit 構成パラメーターによって定義された Currently Committed のデフォルトの動作をオーバーライドします。 DB2 for z/OS サーバーの場合、 SQL_ATTR_CONCURRENT_ACCESS_RESOLUTION 属性を使用して、Currently Committed の動作を有効にします。 この動作を指定することに相当する、DB2 for z/OS サーバーで使用可能なデータベース構成パラメーターはありません。

DB2 for i V6R1 サーバーでは、オプション 0 および 2 のみがサポートされます。DB2 for i V7R1 以降のサーバーでは、SQL_ATTR_CONCURRENT_ACCESS_RESOLUTION 属性の使用可能なすべてのオプションがサポートされます。

ConcurrentAccessResolution CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

• コンテキストを設定する、 有効なコンテキスト (sqleBeginCtx() DB2 API によって割り当てられているもの)。
• コンテキストをリセットする NULL ポインター。

この属性を使用できるのは、 アプリケーションが DB2 コンテキスト API を使ってマルチスレッド・アプリケーションを管理している場合だけです。 デフォルト設定では、CLI は接続ハンドルごとに 1 つのコンテキストを割り当て、 実行スレッドが確実に正しいコンテキストにアタッチされるようにすることにより、 コンテキストを管理しています。

コンテキストの詳細については、sqleBeginCtx() API を参照してください。

Informix® データベースにアクセスする場合、この属性はサポートされません。

• 0 から 999 までの整数
• SQL_CONN_CATALOG_NODE

この変数を設定しない場合のデフォルトのターゲット論理ノードは、 マシン上でポート 0 と定義された論理ノードになります。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

また、対応するキーワード、ConnectNode CLI/ODBC 構成キーワードがあります。

• SQL_CD_FALSE - 接続はアクティブのままです。
• SQL_CD_TRUE - エラーが起きたので、サーバーへの接続が終了されました。この場合でもアプリケーションは切断を実行して、すべての CLI リソースの終結処理を行う必要があります。

この属性が主に使用されるのは、接続をプールする前の Microsoft ODBC Driver Manager 3.5x においてです。

• SQL_CONCURRENT_TRANS (デフォルト): アプリケーションを使用して、1 つ以上のデータベースへの並行複数接続を行うことができます。 各接続には、それぞれのコミット範囲があります。 トランザクションの調整の実施は試みられません。 あるアプリケーションが SQLEndTran() 上の環境ハンドルを使用してコミットを発行したが、 すべての接続コミットが成功したわけではない場合、そのアプリケーションはリカバリーを行う必要があります。
• SQL_COORDINATED_TRANS: アプリケーションはコミットを行い、 複数のデータベース接続で調整をロールバックします。 このオプション設定は、組み込み SQL のタイプ 2 CONNECT の指定に対応しています。 SQL_CONCURRENT_TRANS 設定とは対照的に、 アプリケーションは 1 つのデータベースにつき 1 つのオープン接続のみを許可されます。
  注: この接続タイプでは、 SQL_ATTR_AUTOCOMMIT 接続オプションのデフォルト値である SQL_AUTOCOMMIT_OFF の設定になります。

この属性をデフォルトから変更する場合、接続を環境ハンドルに対して確立する前にこれを設定する必要があります。

環境ハンドルが割り振られたら、必要に応じて、 アプリケーションはできる限り即時に SQLSetEnvAttr() への呼び出しを行って、 この属性を環境属性として設定することが推奨されています。 しかし、ODBC アプリケーションは SQLSetEnvAttr() にアクセスできないので、 個々の接続ハンドルが割り振られてから接続が確立されるまでの間に、SQLSetConnectAttr() を使用してこの属性を設定しなければなりません。

環境ハンドル上のすべての接続の SQL_ATTR_CONNECTTYPE 設定は、同じでなければなりません。 環境では、並行接続と整合接続を混合して使うことはできません。 最初の接続のタイプが決まると、それ以降のすべての接続のタイプはそれに従います。 SQLSetEnvAttr() は、接続アクティブに接続タイプを変更しようとすると、 エラーが返されます。

ConnectType CLI/ODBC 構成キーワードを使用して、このデフォルト接続タイプを設定することもできます。

この接続属性は、SQLGetConnectAttr() によって戻せますが、 SQLSetConnectAttr() で設定することはできません。 この属性を設定しようとすると、 SQLSTATE は HYC00 (ドライバーが機能しない) になります。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

この属性は、 CLI アプリケーションではなく ODBC 静的処理アプリケーションで使用することに最も適しています。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

後続の SQL ステートメント用のパッケージの選択に使用されるスキーマ名 (コレクション ID) を示すヌル終了文字ストリング。 この属性を設定すると、 SET CURRENT PACKAGESET SQL ステートメントが発行されます。 この属性が接続以前に設定された場合、 接続時に SET CURRENT PACKAGESET SQL ステートメントが発行されます。

CurrentPackageSet CLI/ODBC 構成キーワード の設定は、スキーマ名を指定する別の方法です。

次のパッケージ・セット名は予約済みです。NULLID、NULLIDR1、NULLIDRA。

SQL_ATTR_REOPT と SQL_ATTR_CURRENT_PACKAGE_SET を同時に指定することはできません。したがって、一方を設定すると、他方は許可されません。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

このオプションをリセットするには、 ValuePtr 引数で長さゼロのストリングまたは NULL ポインターを使ってこのオプションを指定します。

このオプションは、アプリケーション開発者が、 SQLColumns() への一般呼び出しを次のようにコーディングしてある場合に便利です。 つまり、スキーマ名で結果セットを制限せず、 結果セットをコード内で孤立させて制約をかける必要がある場合です。

このオプションはいつでも設定することができますが、 szSchemaName ポインターが NULL である次の SQLColumns() 呼び出しで有効になります。

• SQL_IBMi_FMT_ISO: 国際標準化機構 (ISO) の日付形式 yyyy-mm-dd を使用します。
• SQL_IBMi_FMT_USA: 米国の日付形式 mm/dd/yyyy を使用します。
• SQL_IBMi_FMT_EUR: ヨーロッパの日付形式 dd.mm.yyyy を使用します。
• SQL_IBMi_FMT_JIS: 日本工業規格の日付形式 yyyy-mm-dd を使用します。
• SQL_IBMi_FMT_MDY: 日付形式 mm/dd/yy を使用します。
• SQL_IBMi_FMT_DMY: 日付形式 dd/mm/yy を使用します。
• SQL_IBMi_FMT_YMD: 日付形式 yy/mm/dd を使用します。
• SQL_IBMi_FMT_JUL: ユリウス日付形式 yy/ddd を使用します。
• SQL_IBMi_FMT_JOB: ジョブのデフォルトの日付形式を使用します。

SQL_ATTR_DATE_FMT 属性のデフォルト値は、パッケージに対して指定されている DATETIME バインド・オプションによって決まります。 CLI パッケージに対してデフォルトの DATETIME バインド・オプションが指定されている場合、 SQL_IBMi_FMT_ISO が SQL_ATTR_DATE_FMT 属性のデフォルト値になります。

• SQL_SEP_SLASH: 日付区切り記号にスラッシュ ( / ) を使用します。
• SQL_SEP_DASH: 日付区切り記号にダッシュ ( - ) を使用します。
• SQL_SEP_PERIOD: 日付区切り記号にピリオド ( . ) を使用します。
• SQL_SEP_COMMA: 日付区切り記号にコンマ ( , ) を使用します。
• SQL_SEP_BLANK: 日付区切り記号にブランクを使用します。
• SQL_SEP_JOB: ジョブのデフォルトの日付区切り記号を使用します。

SQL_ATTR_DATE_SEP 属性のデフォルト値は、パッケージに対して指定されている DATETIME バインド・オプションによって決まります。 CLI パッケージに対してデフォルトの DATETIME バインド・オプションが指定されている場合、 SQL_SEP_SLASH が SQL_ATTR_DATE_SEP 属性のデフォルト値になります。

• SQL_IBMi_FMT_MDY
• SQL_IBMi_FMT_DMY
• SQL_IBMi_FMT_YMD
• SQL_IBMi_FMT_JUL

この接続属性は、SQLGetConnectAttr() によって戻せますが、 SQLSetConnectAttr() で設定することはできません。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

この接続属性は、SQLGetConnectAttr() によって戻せますが、 SQLSetConnectAttr() で設定することはできません。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

製品を示す 3 文字の ID の後に、製品のバージョン、リリース、 および修正レベルを示す 5 桁の英数字が続きます。 A-Z の文字はレベル 9 より上の修正レベルを示しています。A は修正レベル 10 を、B は修正レベル 11 を示す、という具合です。 例えば、SQL0907C とは、DB2 バージョン 9 リリース 7 修正レベル 12 を示しています。

SQLCODE がエラー条件を示している場合は、このフィールドはエラーを戻したモジュールを識別します。

接続が正しく完了したときにも、このフィールドが使用されます。

• SQL_DB2EXPLAIN_OFF: Explain スナップショット機能も Explain 表オプション機能も無効になっています (SET CURRENT EXPLAIN SNAPSHOT=NO と SET CURRENT EXPLAIN MODE=NO がサーバーに送信されます)。
• SQL_DB2EXPLAIN_SNAPSHOT_ON: Explain スナップショット機能は有効、Explain 表オプション機能は無効になっています (SET CURRENT EXPLAIN SNAPSHOT=YES と SET CURRENT EXPLAIN MODE=NO がサーバーに送信されます)。
• SQL_DB2EXPLAIN_MODE_ON: Explain スナップショット機能は有効、Explain 表オプション機能は無効になっています (SET CURRENT EXPLAIN SNAPSHOT=NO と SET CURRENT EXPLAIN MODE=YES がサーバーに送信されます)。
• SQL_DB2EXPLAIN_SNAPSHOT_MODE_ON: Explain スナップショット機能も Explain 表オプション機能も有効になっています (SET CURRENT EXPLAIN SNAPSHOT=YES と SET CURRENT EXPLAIN MODE=YES がサーバーに送信されます)。

Explain 情報を生成する前に、Explain 表を作成する必要があります。

このステートメントはトランザクションに制御されませんし、ROLLBACK の影響も受けません。 新規の SQL_ATTR_DB2EXPLAIN 設定は、この接続の次のステートメント準備で有効になります。

現在の許可 ID に、EXPLAIN 表の INSERT 特権が必要です。

DB2Explain CLI/ODBC 構成キーワードを使用してデフォルト値を設定することもできます。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_TRUE: DB2 for i システム命名モードが使用されます。 ファイルは、スラッシュ (/) 区切り文字を使って修飾されます。 修飾されていないファイルは、ジョブ用のライブラリー・リストを使って解決されます。
• SQL_FALSE: SQL 命名モード (デフォルト値)。 ファイルは、ピリオド (.) 区切り文字を使って修飾されます。 修飾されていないファイルは、デフォルト・ライブラリーまたは現在のユーザー ID を使って解決されます。

cliRC = SQLSetConnectAttr(hdbc,
                          SQL_ATTR_DBC_SYS_NAMING ,
                          (SQLPOINTER)SQL_TRUE,
                          SQL_NTS);

10 進数浮動小数点丸めモードは、DECFLOAT の変数または列に入っている値の桁数が DECFLOAT データ・タイプで許可される桁数を超えている場合に、どのタイプの丸めを使用するかを決定します。 このようなことは、別のタイプから挿入、更新、選択、変換する際、あるいは数学演算の結果として生じることがあります。

SQL_ATTR_DECFLOAT_ROUNDING_MODE の値は、新しい接続の接続属性によって他のモードが指定されていない場合に、その新しい接続で使用される 10 進数浮動小数点丸めモードを決定します。指定されたどの接続に対しても、CLI および DB2 の両方が、その接続の一部として開始されるすべてのアクションで、同じ 10 進数浮動小数点丸めモードを使用します。

アプリケーションが DB2 for Linux, UNIX, and Windows バージョン 9.5 サーバーに接続する場合は、データベース・クライアントの 10 進数浮動小数点丸めモードを、サーバーで設定されているのと同じモードに設定する必要があります。クライアントの 10 進数浮動小数点丸めモードを、データベース・サーバーで設定されている 10 進数浮動小数点丸めモードとは異なる値に設定していると、接続時にデータベース・サーバーから SQL0713N が戻されます。

これらの 10 進数浮動小数点丸めモードに対応する設定値は、次のとおり。

• 0 = Half even (デフォルト)
• 1 = Half up
• 2 = Down
• 3 = Ceiling
• 4 = Floor

各モードは、次のとおりです。

Half even (デフォルト)

このモードでは、CLI および DB2 は、ターゲット変数に収まり、元の値に最も近似の数値を使用します。 2 つの数値がほぼ同じ程度の近似値の場合には、偶数であるものを使用します。 このモードは、大量のデータに対して、生じる丸め誤差を最も小さくします。

Half up

このモードでは、CLI および DB2 は、ターゲット変数に収まり、元の値に最も近似の数値を使用します。 2 つの数値がほぼ同じ程度の近似値の場合には、元の値よりも大きいものを使用します。

Down

このモードでは、CLI および DB2 は、ターゲット変数に収まり、元の値に最も近似で、その絶対値が元の値の絶対値よりも大きくない数値を使用します。 これは、ゼロに向かっての丸め、または負の値の場合の Ceiling の使用、および正の値の場合の Floor の使用とみなすことができます。

Ceiling

このモードでは、CLI および DB2 は、ターゲット変数に収まり、元の値より大か等しい数値で最小のものを使用します。

Floor

このモードでは、CLI および DB2 は、ターゲット変数に収まり、元の値より小か等しい数値で最大のものを使用します。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_SEP_PERIOD: 小数点にピリオド ( . ) を使用します。
• SQL_SEP_COMMA: 小数点にコンマ ( , ) を使用します。
• SQL_SEP_JOB: ジョブのデフォルトの小数点を使用します。

SQL_ATTR_DECIMAL_SEP 属性のデフォルト値は、パッケージに対して指定した DECDEL バインド・オプションによって決まります。 CLI パッケージに対してデフォルトの DECDEL バインド・オプションを指定した場合は、SQL_SEP_PERIOD が SQL_ATTR_DECIMAL_SEP 属性のデフォルト値になります。

• 1 = SQL_DESCRIBE_CALL_BEFORE。
• -1 = SQL_DESCRIBE_CALL_DEFAULT。

DescribeCall CLI/ODBC 構成キーワードを使用してこの属性を設定することができます。 選択可能なオプションの使用法情報および説明については、キーワードを参照してください。

• 0 - 記述情報は、クライアント・アプリケーションに戻されません。
• 1 - レベル 1 に分類される記述情報 (表 2 を参照) が、クライアント・アプリケーションに戻されます。
• 2 - (デフォルト) レベル 2 に分類される記述情報 (表 2 を参照) が、クライアント・アプリケーションに戻されます。
• 3 - レベル 3 に分類される記述情報 (表 2 を参照) が、クライアント・アプリケーションに戻されます。

以下の表は、サーバーが準備要求または記述要求を受け取ったときに戻す、記述情報を形成するフィールドをリストします。 これらのフィールドは各レベルにグループ化され、SQL_ATTR_DESCRIBE_OUTPUT_LEVEL 属性が、CLI ドライバーの要求する記述情報のレベルを制御します。

SQL_COLUMN_COUNT
SQL_COLUMN_LENGTH
SQL_COLUMN_NULLABLE
SQL_COLUMN_PRECISION
SQL_COLUMN_SCALE
SQL_DESC_CASE_SENSITIVE
SQL_DESC_CONCISE_TYPE
SQL_DESC_COUNT
SQL_DESC_DISPLAY_SIZE
SQL_DESC_FIXED_PREC_SCALE
SQL_DESC_LENGTH
SQL_DESC_LITERAL_PREFIX
SQL_DESC_LITERAL_SUFFIX
SQL_DESC_NULLABLE
SQL_DESC_OCTET_LENGTH
SQL_DESC_PRECISION
SQL_DESC_SEARCHABLE
SQL_DESC_SCALE
SQL_DESC_TYPE
SQL_DESC_UNSIGNED

all fields of level 1 and:
SQL_COLUMN_NAME
SQL_DESC_DISTINCT_TYPE
SQL_DESC_LABEL
SQL_DESC_LOCAL_TYPE_NAME
SQL_DESC_NAME
SQL_DESC_REFERENCE_TYPE
SQL_DESC_STRUCTURED_TYPE
SQL_DESC_TYPE_NAME
SQL_DESC_UNNAMED
SQL_DESC_USER_DEFINED_
         TYPE_CODE
SQL_DESC_USER_TYPE

all fields of levels 1
and 2 and:
SQL_DESC_AUTO_UNIQUE_VALUE
SQL_DESC_BASE_COLUMN_NAME
SQL_DESC_BASE_TABLE_NAME
SQL_DESC_CATALOG_NAME
SQL_DESC_IDENTITY_VALUE
SQL_DESC_SCHEMA_NAME
SQL_DESC_TABLE_NAME
SQL_DESC_UPDATABLE

DescribeOutputLevel CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

1. DB2® for Linux, UNIX, and Windows バージョン 10.5 フィックスパック 4 以降のフィックスパック。
2. 自動クライアント・リルート・フィーチャーと Sysplex ワークロード・バランシング・フィーチャーが有効になっている、新機能モード (NFM) の DB2 for z/OS® バージョン 11。

• SQL_DETECT_READ_ONLY_TXN_ENABLE - 自動クライアント・リルート・フィーチャーが有効になっている場合に、失敗したステートメントがトランザクション内の最初の SQL ステートメントでなくても、接続を新規メンバーにシームレスにフェイルオーバーできることを示します。この設定にすると、接続されているサーバーは、特殊レジスターおよびセッション・グローバル変数が変更されるたびにそれらの最新の値を返します。
• SQL_DETECT_READ_ONLY_TXN_DISABLE(デフォルト) - このフィーチャーを無効にします。

• NULL 以外のトランザクション・ポインター: アプリケーションは、接続の状態を非分散トランザクション状態から分散トランザクション状態に変更するよう、CLI に要求します。 接続の参加は、分散トランザクション・コーディネーター (DTC) によって行われます。
• NULL: アプリケーションは、接続の状態を分散トランザクション状態から非分散トランザクション状態に変更するよう、CLI に要求します。

この属性は、Microsoft Transaction Server (MTS) との接続の参加、 または参加の取り止めを行うために、MTS の環境でのみ使用されます。

• SQL_EXTENDED_INDICATOR_ENABLE: この場合、ユーザーは SQLBindParameter() / SQLExtendedBind() メソッドに SQL_UNASSIGNED と SQL_DEFAULT_PARAM を示す値を指定できます。
• SQL_EXTENDED_INDICATOR_NOT_SET (デフォルト): このフィーチャーはデフォルトで使用不可になっています。 SQL_ATTR_EXTENDED_INDICATORS を使用してこのフィーチャーを使用可能にする前に SQL_UNASSIGNED と SQL_DEFAULT_PARAM が使用されると、ユーザーは InvalidArgument 値エラー CLI0124E を受け取ります。
• 以下の IBM Data Server 製品では、拡張標識がサポートされます。
  • DB2 for Linux, UNIX, and Windows データベース・サーバー。
  • DB2 for z/OS バージョン 10 サーバー。
  • DB2 for i V7.1 データ・サーバー。

実行時データ・フローにおいて、ユーザーのアプリケーションで SQL_ROLLBACK を CompletionType と指定したSQLEndTran() 関数を呼び出すには、StreamPutData 構成キーワードを 1 に設定し、SQL_ATTR_FORCE_ROLLBACK 接続属性も設定する必要があります。

DB2 for z/OS サーバーではないデータベース・サーバーへの接続では、CLI0150E エラー・メッセージが戻されます。

• Dynamic Data Format フィーチャーをサポートしないサーバーから LOB 列をクライアントがフェッチする場合。
• AllowInterleavedGetData キーワードを設定した SQLGetData() 関数をクライアントが呼び出す場合。

• SQL_FREE_MEMORY_ON_STMTCLOSE_NO: デフォルト値。 指定されたシナリオの CLI ドライバーによるメモリーの割り振りは、SQL_CLOSE アクションが実行された時点で解放されません。
• SQL_FREE_MEMORY_ON_STMTCLOSE_YES: 指定されたシナリオの CLI ドライバーによるメモリーの割り振りは SQL_CLOSE アクションが実行されたときに解放されます。

cliRC = SQLSetConnectAttr(hdbc,
                          SQL_ATTR_FREE_MEMORY_ON_STMTCLOSE ,
                          (SQLPOINTER)SQL_FREE_MEMORY_ON_STMTCLOSE_YES,
                          SQL_IS_INTEGER);

ワークロード・バランシング (WLB) フィーチャーが有効な場合、最後のメンバー・アドレスをメンバー・アドレス、1 次グループ・アドレス、または代替グループ・アドレスとすることができます。 WLB が有効でない場合、SQL_ATTR_GET_LATEST_MEMBER 属性は、論理接続の確立に使用されている DSN 情報を返します。 返された DSN 情報は、1 次グループ・アドレスまたは代替グループ・アドレスとすることができます。 DSN 情報は、ローカル db2dsdriver.cfg ファイル、または、db2dsdriver.cfg ファイルが使用されていない場合はノード・ディレクトリーから取得されます。 代替グループ・アドレスは、ローカル db2dsdriver.cfg ファイルから取得されます。 戻り値は IP アドレスとポートであり、ポート番号またはサービス名として表されます。 戻り値の形式は、"hostname:port" です。

データベース接続を確立する前にこの属性を使用しようとすると、CLI0106E エラー・メッセージが戻されます。

SQL_ATTR_GET_LATEST_MEMBER_NAME 属性は、db2dsdriver.cfg ファイルでクライアント・アフィニティー・フィーチャーが有効な場合にのみ指定できます。

メンバー名情報は、ローカルの db2dsdriver.cfg ファイルの <alternateserverlist> サブセクションから取得されます。

DB2 for z/OS サーバーへの接続については、自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランス (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの発生時に SQL_ATTR_INFO_ACCTSTR 属性は再生されます。

SQL_ATTR_INFO_ACCTSTR 属性は、IBM 定義の属性です。

DB2 for z/OS サーバーへの接続については、自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランス (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの発生時に SQL_ATTR_INFO_APPLNAME 属性は再生されます。

クライアント・アプリケーション名を変更し、WLM_SET_CLIENT_INFO プロシージャーを使用してアカウンティング・ストリングを設定すると、サーバーに保管されているアカウンティング・ストリングが、クライアント情報からのアカウンティング・ストリングの値によって更新されます。

SQL_ATTR_INFO_APPLNAME 属性は、IBM 定義の属性です。

デフォルトの SQL_ATTR_INFO_CRRTKN 属性値は、接続時に生成される DRDA® 相関トークンです。データベース・クライアントは一般的に、DRDA 相関トークン値を生成します。ただし、データベース・クライアントが値を生成できない場合は、データベース・サーバーが値を生成します。

SQL_ATTR_INFO_CRRTKN 属性は、IBM 定義の属性です。

この属性は、DB2 for z/OS バージョン 8 以降または Informix データベース・サーバー にアクセスする CLI アプリケーションの場合にのみ、サポートされます。

サーバーとの接続が確立されるより前にこの属性が設定されている場合、 ここに指定される値は実際のクライアント・アプリケーション名をオーバーライドし、 appl_name モニター・エレメントに表示される値になります。 DB2 for z/OS サーバーとの接続では、 この設定値の最初の 12 文字が、 対応する DB2 for z/OS スレッドの CORRELATION IDENTIFIER として使用されます。

 CLI ドライバーにより、SQL_ATTR_INFO_USERID 属性の文字数は 255 文字に制限されます。

DB2 for z/OS サーバーへの接続については、自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランス (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの発生時に SQL_ATTR_INFO_USERID 属性は再生されます。

クライアント・ユーザー ID を変更し、WLM_SET_CLIENT_INFO プロシージャーを使用してアカウンティング・ストリングを設定すると、サーバーに保管されているアカウンティング・ストリングが、クライアント情報からのアカウンティング・ストリングの値によって更新されます。

SQL_ATTR_INFO_USERID 属性は、IBM 定義の属性です。

SQL_ATTR_INFO_WRKSTNNAME 属性が指定されていない場合、ホスト名からなるデフォルト値が使用されます。ホスト名は、gethostname() 関数を呼び出すことによって取得されます。ホスト名が構成されていない場合、または gethostname() 関数呼び出しでエラーが発生した場合には、SQL_ATTR_INFO_WRKSTNNAME 属性の値はサーバーに送信されません。

DB2 for z/OS サーバーへの接続については、自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランス (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの発生時に SQL_ATTR_INFO_WRKSTNNAME 属性は再生されます。

SQL_ATTR_INFO_WRKSTNNAME 属性は、IBM 定義の属性です。

• 0 - KEEPDYNAMIC 機能は利用できません。 CLI パッケージは KEEPDYNAMIC NO オプションを指定してバインドされました。
• 1 - KEEPDYNAMIC 機能を利用できます。 CLI パッケージは KEEPDYNAMIC YES オプションを指定してバインドされました。

この属性が設定されている場合には、 SQL_ATTR_CURRENT_PACKAGE_SET 属性も設定するようお勧めします。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

詳しい使用情報については、LOBCacheSize CLI/ODBC 構成キーワードを参照してください。

接続タイムアウト値の設定は、ConnectTimeout CLI/ODBC 構成キーワードを使用して行うこともできます。 使用法の情報については、キーワードを参照してください。

• SQL_LD_COMPAT_NO (デフォルト): ラージ・オブジェクト・データ・タイプは、IBM 定義のタイプ (SQL_BLOB、SQL_CLOB、SQL_DBCLOB) で報告されます。
• SQL_LD_COMPAT_YES: IBM ラージ・オブジェクト・データ・タイプ (SQL_BLOB、SQL_CLOB、および SQL_DBCLOB) は、 SQL_LONGVARBINARY、SQL_LONGVARCHAR、および SQL_LONGVARGRAPHIC にマップされます。 SQLGetTypeInfo() は、SQL_LONGVARBINARY SQL_LONGVARCHAR、および SQL_LONGVARGRAPHIC にそれぞれ 1 つの項目を戻します。

• SQL_MAPCHAR_DEFAULT (デフォルト): デフォルトの SQL タイプ表記を戻します。
• SQL_MAPCHAR_WCHAR: SQL_WCHAR として SQL_CHAR、SQL_WVARCHAR として SQL_VARCHAR、および SQL_WLONGVARCHAR として SQL_LONGVARCHAR を戻します。

SQL_CHAR、SQL_VARCHAR、SQL_LONGVARCHAR に関連したデフォルトの SQL タイプの設定は、MapCharToWChar CLI/ODBC 構成キーワードを使用して行うこともできます。

データ検索時にサーバーは、最大ブロック・サイズに到達する場合でも、現在行に関するすべての情報をクライアントへの応答に含めます。

MaxLOBBlockSize キーワードと db2set レジストリー変数 DB2_MAX_LOB_BLOCK_SIZE の両方が指定されている場合、MaxLOBBlockSize キーワードの値が使用されます。

LOB または XML データ・ブロックの最大サイズを指定するために、代わりに MaxLOBBlockSize CLI/ODBC 構成キーワードを設定することもできます。

SQL_NETWORK_STATISTICS_OFF (デフォルト)

接続のネットワーク統計の収集を無効にします。

SQL_NETWORK_STATISTICS_ON

接続のネットワーク統計の収集を有効にします。

SQL_NETWORK_STATISTICS_ON_SKIP_NOSERVER

接続に対してネットワーク統計の収集を使用可能にすることに加えて、明示的な COMMIT ステートメントや ROLLBACK ステートメントなど、サーバー時間が報告されていないと認識されているネットワーク・フローは省略されます。

サーバー時間が報告されていない要求は、サーバー時間をネットワーク時間から減算する計算が行われる場合、戻り情報の有用性に影響を与えることがあります。 SQL_NETWORK_STATISTICS_ON_SKIP_NOSERVER オプションは、これらの要求を報告される値から除外します。 非チェーンの明示的要求のみ除外されます。 自動コミットおよびチェーニングされた COMMIT ステートメントはスキップされません。

CLI ドライバーは COMMIT および ROLLBACK で報告されるサーバー時間の統計を収集します。 IBM データ・サーバーは、COMMIT および ROLLBACK のサーバー時間を報告するフィーチャーをサポートしている必要があります。

データベース・コード・ページと同じコード・ページを指定すると、アプリケーションは、コード・ページ変換を行わなくても、CHARACTER データ・タイプのデータをフェッチまたは挿入できます。

ステートメント・ハンドルを割り振った後で SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE 属性を設定すると、CLI0126E エラー (無効な操作) が発生します。 この属性をデータベースでサポートされていない値に設定すると、CLI0210E エラー (不整合なコード・ページ値のエラー) になります。

SQL_ATTR_OVERRIDE_CODEPAGE を SQL_OVERRIDE_CODEPAGE_ON に設定した後で SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE を設定すると、CLI ドライバーは CLI0126E エラー・メッセージを返します。

バインド・アウト操作の際には、バインド・アウト操作中に取得したデータを保持するのに十分な大きさのバッファーを、CLI アプリケーションによって割り振るようにしてください。スペースが不十分な場合は、CLI0002W エラーが戻されます。

• SQL_OVERRIDE_CODEPAGE_ON: CLI ドライバーは、文字データまたはグラフィック・データのバインディングに対して、コード・ページ変換を実行しません。
• SQL_OVERRIDE_CODEPAGE_OFF (デフォルト): CLI ドライバーは文字データまたはグラフィック・データのバインディングに対して、コード・ページ変換を実行します。

SQL_ATTR_OVERRIDE_CODEPAGE 属性を SQL_OVERRIDE_CODEPAGE_ON に設定する場合は、データが適切なコード・ページにあることを確認する必要があります。

SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE を設定した後で SQL_ATTR_OVERRIDE_CODEPAGE を SQL_OVERRIDE_CODEPAGE_ON に設定すると、CLI ドライバーは CLI0126E エラー・メッセージを返します。

SQL_ATTR_OVERRIDE_PRIMARY_AFFINITY 属性に空ストリング値を指定すると、基本メンバーが、db2dsdriver.cfg ファイルにリストされているクライアント・アフィニティー・フィーチャーの最初のメンバーに戻されます。

SQL_ATTR_OVERRIDE_PRIMARY_AFFINITY 属性で指定された新規一時基本メンバーは、メモリーに保管され、db2dsdriver.cfg ファイルにリストされているメンバーの順序に影響しません。

• SQL_PARC_BATCH_ENABLE: CLI は、各パラメーター・セットによって影響を受けた表の行数を返します。
• SQL_PARC_BATCH_DISABLE (デフォルト): CLI は、パラメーター・セット全体に対して影響を受けた行の合計数を返します。

この接続属性を SQL_PARCH_BATCH_ENABLE に設定する場合、配列を RowCountPtr パラメーターとして SQLRowCount () 関数で指定し、SQL_ATTR_PARAMOPT_ATOMIC を SQL_ATOMIC_NO に設定する必要があります。SQL_ATTR_PARAMOPT_ATOMIC が SQL_ATOMIC_YES に設定されていると、SQLExecute() 関数を呼び出した時点で、CLI0150E エラー・メッセージが返されます。

既存の接続がデータベースによって削除された場合は、値 0 が報告されます。接続がアプリケーションによってクローズされる場合、SQLSTATE の 08003 が報告されます。 SQL_ATTR_PING_DB 属性は、SQLGetConnectAttr() 関数で返すことはできますが、SQLSetConnectAttr() 関数で設定することはできません。 この属性を設定しようとすると、 SQLSTATE は 7HYC00 (ドライバーが機能しない) になります。

アプリケーションがこのオプションを指定して SQLSetConnectAttr() を呼び出したことがない場合、 CLI はこのオプションに、 SQLGetConnectAttr() に対する NULL の親ウィンドウ・ハンドルを戻し、 NULL の親ウィンドウ・ハンドルを使用してダイアログ・ボックスを表示します。 例えば、エンド・ユーザーが (CLI 初期設定ファイルの項目を介して) オプティマイザー情報を表示するよう求めると、 CLI は NULL のウィンドウ・ハンドルを使用してこの情報が入っているダイアログ・ボックスを表示します。 (プラットフォームによっては、ダイアログ・ボックスが画面の中央に表示されます。)

ValuePtr を NULL に設定すると、CLI はダイアログ・ボックスを表示しません。 エンド・ユーザーがオプティマイザー見積もりを表示するよう求める場合には、 アプリケーションが明示的にそのようなダイアログ・ボックスをすべて抑止するので、 CLI はこれらの見積もりを表示しません。

ValuePtr が NULL ではない場合、アプリケーションの親ウィンドウ・ハンドルになるはずです。 CLI は、このハンドルを使ってダイアログ・ボックスを表示します。 (プラットフォームによっては、 ダイアログ・ボックスがアプリケーションのアクティブ・ウィンドウとの関係において、 中央に表示されます。)

• SQL_READ_ONLY_CONNECTION_ON: SQL_READ_ONLY_CONNECTION_ON 属性の設定後に作成される新規接続が読み取り専用であることを指定します。
• SQL_READ_ONLYCONNECTION_OFF: デフォルト値。SQL_READ_ONLYCONNECTION_OFF 属性の設定後に作成される新規接続が読み取り専用ではないことを指定します。データベース・オブジェクトへのアクセスは、サーバーのユーザー ID に関連付けられている権限によって制御されます。

Informix データベース・サーバーに接続している場合は、SQL_ATTR_READ_ONLY_CONNECTION 属性を指定できません。

試行を終了し、通信タイムアウト・エラーを生成する前の、確立された接続でのサーバーからの応答をクライアントが待機する秒数を指定する、32 ビット整数値。 デフォルト値の 0 は、クライアントが応答を無制限に待機することを示します。 受信タイムアウトは、接続の確立中は効果がありません。また、TCP/IP プロトコルに対してのみサポートされ、その他のプロトコルの場合は無視されます。 サポートされる値は、 0 から 32767 までの整数です。

db2 bind db2clipk.bnd collection NULLIDR1
db2 bind db2clipk.bnd collection NULLIDRA 

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• 0 (デフォルト): LONG タイプ (LONG VARCHAR、LONG VARCHAR FOR BIT DATA、LONG VARGRAPHIC、および LONG VARGRAPHIC FOR BIT DATA) は、DBCOLUMNFLAGS_ISLONG フラグを設定しません。そのため、WHERE 節でその列が使用されることがあります。
• 1: IBM DB2 OLE DB Provider は LONG タイプ (LONG VARCHAR、LONG VARCHAR FOR BIT DATA、LONG VARGRAPHIC、および LONG VARGRAPHIC FOR BIT DATA) を、DBCOLUMNFLAGS_ISLONG フラグを設定して報告します。 これは、WHERE 節で long 列が使用されるのを防ぎます。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_REPORT_SEAMLESSFAILOVER_WARNING_YES: シームレス・フェイルオーバーが接続要求または実行要求中に発生した場合、警告メッセージが返されます。
• SQL_REPORT_SEAMLESSFAILOVER_WARNING_NO (デフォルト): シームレス・フェイルオーバーが接続要求または実行要求中に発生した場合、警告メッセージが返されません。

• 0 (デフォルト): 日時オーバーフローはエラーにつながる (SQLSTATE 22008)。
• 1: 日時オーバーフローは警告につながる (SQLSTATE 01S07)。

CLI ドライバーは、SQLBindParameter() または SQLExtendedBind() 関数を使用して指定したパラメーターごとに 100 個の要素で構成される配列バッファーを割り振ります。 サーバー上のリソース競合問題が原因でエラーが発生すると、CLI ドライバーは失敗した行の配列を構成し、ステートメントを SQL_ATTR_RETRY_ON_MERGE 属性で設定された反復の回数再実行します。

• 0 (デフォルト): デフォルト値。再試行は行われません。
• 1-6: 実行可能な再試行の回数。最大再試行回数は 6 回です。

• SQL_ATTR_SERVER_MSGTXT_MASK_LOCAL_FIRST (デフォルト): CLI は、ローカル・メッセージ・ファイルを最初に調べて、メッセージを検索できるかどうかを確かめます。 一致する SQLCODE が見つからない場合、CLI はサーバーから情報を要求します。
• SQL_ATTR_SERVER_MSGTXT_MASK_WARNINGS: CLI は常に、警告に関するサーバーからのメッセージ情報を要求しますが、エラー・メッセージがローカル・メッセージ・ファイルから取り出されます。
• SQL_ATTR_SERVER_MSGTXT_MASK_ERRORS: CLI は常に、エラーに関するサーバーからのメッセージ情報を要求しますが、警告メッセージがローカル・メッセージ・ファイルから取り出されます。
• SQL_ATTR_SERVER_MSGTXT_MASK_ALL: CLI は常に、エラーと警告メッセージの両方に関する情報をサーバーから要求します。

ServerMsgMask CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

• SYSIBM.SQLCAMESSAGE: メッセージ・テキストを DB2 for z/OS サーバーから取り出すために呼び出されるデフォルト・プロシージャー。この属性を設定しない場合は、このプロシージャーが呼び出されます。
• DSNACCMG: メッセージ・テキストを DB2 for z/OS バージョン 7 サーバーから取り出すために呼び出されるデフォルト・プロシージャー。メッセージ・テキストを DB2 for z/OS バージョン 8 以降から取り出すためには、SYSIBM.SQLCAMESSAGE プロシージャーが呼び出されます。DSNACCMG は、DB2 for z/OS バージョン 9 では推奨されておらず、将来のリリースで除去される可能性があります。
• ユーザーが作成したストアード・プロシージャー

この属性を使用するアプリケーションは、SQL_ATTR_SERVER_MSGTXT_MASK 属性も設定して、メッセージ情報をサーバーから取り出すために CLI がいつこのプロシージャーを呼び出すかを示すことができます。 SQL_ATTR_SERVER_MSGTXT_MASK が設定されていない場合、デフォルトで、ローカル・メッセージ・ファイルを最初に調べます (SQL_ATTR_SERVER_MSGTXT_MASK の SQL_ATTR_SERVER_MSGTXT_MASK_LOCAL_FIRST を参照してください)。

UseServerMsgSP CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

• 0 (デフォルト): IBM DB2 OLE DB Provider は、TABLE_CATALOG、TABLE_SCHEMA、TABLE_NAME, COLUMN_NAME 列によってソートされた行セットを戻します。
• 1: IBM DB2 OLE DB Provider は、ORDINAL_POSITION によってソートされた行セットを戻します。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_STMT_CONCENTRATOR_OFF - ステートメント・コンセントレーターの動作は無効です。
• SQL_STMT_CONCENTRATOR_WITH_LITERALS - サーバーがサポートしている状況の場合、ステートメント・コンセントレーターが有効になり、リテラル値を含む動的ステートメントはステートメント・キャッシュを使用します。 例えば、ステートメントにパラメーター・マーカー、名前付きパラメーター・マーカー、またはリテラルとパラメーター・マーカーおよび名前付きパラメーター・マーカーの組み合わせが含まれている場合、ステートメント・コンセントレーターは有効になりません。

StmtConcentrator CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

• 0 (デフォルト): CLI はクライアント上のすべてのデータをバッファーに入れます。
• 1: データをバッファーに入れる必要のないアプリケーションで Dynamic Data Format (プログレッシブ・ストリーミングとも呼ばれる) をサポートするサーバー上のデータを照会している場合は、1 を指定することによって、データをバッファーに入れる必要がないことを示してください。 CLI クライアントは、データ出力ストリームを最適化します。

Dynamic Data Format がサーバーによってサポートされない場合、このキーワードは無視されます。

StreamGetData が 1 に設定されている場合、出力バッファーに入れて戻すためにまだ使用できるバイト数を CLI が判別できない場合、切り捨て発生時に SQLGetData() は長さとして SQL_NO_TOTAL (-4) を戻します。 それ以外の場合、SQLGetData() は、まだ使用できるバイト数を戻します。

StreamGetData CLI/ODBC 構成キーワードの設定は、この動作を指定する別の方法です。

• SQL_STREAM_OUTPUTLOB_ON_CALL_FALSE (デフォルト): CALL ステートメントの OUT パラメーター・データ (LOB データ・タイプまたは XML データ・タイプのデータ) のストリーミングを使用不可にします。
• SQL_STREAM_OUTPUTLOB_ON_CALL_TRUE: CALL ステートメントの OUT パラメーター・データ (LOB データ・タイプまたは XML データ・タイプのデータ) のストリーミングを使用可能にします。

• SQL_IBMi_FMT_ISO: 国際標準化機構 (ISO) の時刻形式 hh.mm.ss を使用します。
• SQL_IBMi_FMT_USA: 米国の時刻形式 hh:mm xx (xx は AM または PM) を使用します。
• SQL_IBMi_FMT_EUR: ヨーロッパの時刻形式 hh.mm.ss を使用します。
• SQL_IBMi_FMT_JIS: 日本工業規格の時刻形式 hh:mm:ss を使用します。
• SQL_IBMi_FMT_HMS: 時刻形式 hh:mm:ss を使用します。

SQL_ATTR_TIME_FMT 属性のデフォルト値は、パッケージに対して指定されている DATETIME バインド・オプションによって決まります。 CLI パッケージに対してデフォルトの DATETIME バインド・オプションを指定した場合は、SQL_IBMi_FMT_JIS が SQL_ATTR_TIME_FMT 属性のデフォルト値になります。

• SQL_SEP_COLON: 時刻区切り記号にコロン ( : ) を指定します。
• SQL_SEP_PERIOD: 時刻区切り記号にピリオド ( . ) を使用します。
• SQL_SEP_COMMA: 時刻区切り記号にコンマ ( , ) を使用します。
• SQL_SEP_BLANK: 時刻区切り記号にブランクを使用します。
• SQL_SEP_JOB: ジョブのデフォルトの時刻区切り記号を使用します。

SQL_ATTR_TIME_SEP 属性のデフォルト値は、パッケージに対して指定されている DATETIME バインド・オプションによって決まります。 CLI パッケージに対してデフォルトの DATETIME バインド・オプションが指定されている場合、 SQL_SEP_COLON が SQL_ATTR_TIME_SEP 属性のデフォルト値になります。

この接続属性を使用する代わりに、Trace CLI/ODBC 構成キーワードを使用して CLI トレース機能を設定することができます。 あるいは、環境属性 SQL_ATTR_TRACE を使用して、トレース・フィーチャーを構成することもできます。 環境属性は ODBC Driver Manager の接続属性と同じ構文を使用しないことに注意してください。

この属性を使用する代わりに TraceFileName CLI/ODBC 構成キーワードを使用して、CLI トレース・ファイル名を設定します。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

ユーザー ID を含む、ユーザー定義ストリング。 ユーザーを切り替えるには、既存のトラステッド接続上でこれを使用します。 トラステッド接続を作成する際には、これを使用しないでください。

この属性を設定した後、次にデータベース・サーバーにアクセスする SQL ステートメントを実行すると、ユーザーの切り替えが行われます。 (SQLSetConnectAttr はデータベース・サーバーにアクセスしません。) ユーザーの切り替えが成功する場合、この属性内のユーザー ID が接続の新規ユーザーになります。 ユーザーの切り替えが失敗すると、切り替えを開始した呼び出しは、失敗の理由を示すエラーを戻します。

ID サーバーを使用していない場合、ユーザー ID はデータベース・サーバー上の有効な許可 ID でなければなりません。 その場合、ID サーバーが認識する任意のユーザー名を使用できます。 (ID サーバーを使用している場合は、SQL_ATTR_USER_REGISTRY_NAME も参照してください。)

接続ハンドルがまだデータベースに接続されていない間にこの属性を設定する場合、または接続がトラステッド接続ではない場合、エラー (CLI0197E) が戻されます。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_TXN_READ_UNCOMMITTED - ダーティー読み取り、反復不能読み取り、幻像読み取りが可能です。
• SQL_TXN_READ_COMMITTED (デフォルト) - ダーティー読み取りが不可能です。 反復不能読み取りと幻像読み取りが可能です。
• SQL_TXN_REPEATABLE_READ - ダーティー読み取りと反復不能読み取りが不可能です。 幻像読み取りが可能です。
• SQL_TXN_SERIALIZABLE - トランザクションがシリアライズ可能です。 ダーティー読み取り、反復不能読み取り、幻像読み取りが不可能です。
• SQL_TXN_NOCOMMIT - 操作が正常に終了したときに、変更内容が有効にコミットされます。 明示コミットやロールバックはできません。 これは、自動コミットに似ています。 これは SQL92 分離レベルではありませんが、DB2 for i サーバーのみがサポートする IBM 定義の属性です。

このオプションは、いずれかのステートメント・ハンドル上にオープン・カーソルがある場合や、 この接続に未解決のトランザクションがある場合は指定できません。 それ以外の場合は、関数呼び出し時に SQL_ERROR (SQLSTATE S1011) が戻されます。

この属性 (または対応するキーワード) を使用できるのは、デフォルトの分離レベルが使用される場合だけです。 アプリケーションが特定の分離レベルを設定する場合は、この属性を設定しても効果はありません。

この属性は、サーバー上で ID マッピング・サービスを使用するユーザーを認証する際にのみ使用されます。 これは、ID マッピング・レジストリーに名前を付けるユーザー定義ストリングに設定されます。 レジストリー名のフォーマットは、使用される ID マッピング・サービスに応じて変化します。 この属性を指定することにより、提供したユーザー名がこのレジストリーにあることがサーバーに通知されます。

この属性を設定した後、次に通常接続を確立しようとするとき、次にトラステッド接続を確立しようとするとき、または次にトラステッド接続でユーザー ID を切り替えようとするときに、値が使用されます。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。

• SQL_WCHARTYPE_CONVERT: データベースにある GRAPHIC SQL データとアプリケーション変数間で、 文字コードが変換されます。 この変換により、アプリケーションで広幅文字ストリング (例えば、L リテラル、 'wc' ストリング関数) を処理する ANSI C メカニズムを最大限に活用できるようになります。データベースと通信する前に、データをマルチバイト・フォーマットに明示的に変換する必要はありません。 不利な点としては、暗黙的な変換により、アプリケーションの実行時パフォーマンスが影響を受け、 メモリー所要量が増える可能性があります。 WCHARTYPE CONVERT を行う必要がある場合、 コンパイル時に C プリプロセッサー・マクロ SQL_WCHART_CONVERT を定義してください。 これにより、DB2 ヘッダー・ファイルにある特定の定義で、 データ・タイプ sqldbchar の代わりに wchar_t を使用することになります。
• SQL_WCHARTYPE_NOCONVERT (デフォルト): アプリケーションとデータベースとの間で、 暗黙的な文字コード変換は行われません。 アプリケーション変数のデータは、非代替 DBCS 文字としてデータベースへ送信され、 かつデータベースから受信します。 この送受信の場合、アプリケーションのパフォーマンスは向上しますが、 アプリケーションが wchar_t (SQLDBCHAR) アプリケーション変数で広幅文字データを使用しなくなったり、 wcstombs() および mbstowcs() ANSI C 関数を明示的に呼び出して、 データをデータベースとやりとりするときに、そのデータをマルチバイト・フォーマットに変換したり、 このフォーマットから変換したりする、という不利な点があります。

• 0: 出力バッファーに追加される宣言またはバイト・オーダー・マーク (BOM) はありません。
• 1: ターゲット・エンコードが UTF-16 または UTF-32 の場合、該当するエンディアン (リトル・エンディアンまたはビッグ・エンディアン) のバイト・オーダー・マーク (BOM) が出力バッファーの前に付加されます。 (UTF-8 BOM がある場合でも、ターゲット・エンコードが UTF-8 であっても、DB2 は UTF-8 BOM を生成しません。)
• 2: XML バージョンだけを含む最小の XML 宣言が生成されます。
• 4: ターゲット・エンコードを識別するエンコード属性が、生成された XML 宣言に追加されます。 そのため、この設定が有効になるのは、この属性の値を計算する際に設定 2 も含まれている場合に限ります。

デフォルト設定は 7 です。これは、XML バージョンとエンコード属性を含む BOM および XML 宣言が暗黙的なシリアライズ中に生成されることを示します。

この設定は、値の変更後に割り振られるステートメント・ハンドルに影響を与えます。 既存のステートメント・ハンドルは元の値を保持します。

Informix データベース・サーバーにアクセスする場合、この属性はサポートされません。