ClientCorrelationToken IBM Data Server Driver 構成キーワード

ClientCorrelationToken キーワードは、 Db2 for z/OS サーバに送信されるクライアント相関トークンを設定する。
同等の CLI キーワード
ClientCorrelationToken
同等の IBM® Data Server Provider for .NET 接続ストリング・キーワード
ClientCorrelationToken
IBM データ・サーバー・ドライバー構成ファイル (db2dsdriver.cfg) の構文
<parameter name="clientCorrelationToken" value="client correlation token"/>
デフォルト設定:
デフォルト値は、接続時に生成される DRDA 相関トークンです。 データベース・クライアントは一般的に、DRDA 相関トークン値を生成します。 ただし、データベース・クライアントが値を生成できない場合は、データベース・サーバーが値を生成します。
使用上の注意:
 
  • Db2 for z/OS バージョン 11 サーバー (新機能モード (NFM)) に接続する場合は、 ClientCorrelationToken キーワードを指定できます。
  • Db2 for z/OS サーバーは、 ClientCorrelationToken キーワード値を使用して CURRENT CLIENT_CORR_TOKEN 特殊レジスターを設定します。
  • Db2 for z/OS サーバーは、 ClientCorrelationToken キーワード値に指定された末尾スペースを削除します。
  • のクライアント相関トークン値の監視サポートはありません。 Db2® コネクトゲートウェイサーバでは
  • ClientCorrelationToken キーワード値は、クライアント・サイドの検証なしでサーバーに送信されます。
  • ClientCorrelationToken キーワードに指定する文字ストリングは、ヌル終了でなければなりません。
  • ClientCorrelationToken キーワードには、255 文字までの制限があります。
  • 自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランス (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの発生時に ClientCorrelationToken キーワードが再生されます。

クライアント情報レジスター値がユーザーによって明示的に設定されていない場合、クライアントはデフォルトの値を Db2 for z/OS サーバーに送信します。 デフォルトの CURRENT CLIENT_CORR_TOKEN 特殊レジスター値は、接続中に生成される DRDA 相関トークンです。 SQLGetConnectAttr() 関数と sqleqryi API は、 IBM データ・サーバー・ドライバー構成ファイルで enableDefaultClientInfo キーワードが True に設定されている場合にのみ、デフォルト値を返すことができます。