データベースに送信されるクライアント・ワークステーション名を設定します。
- 同等の CLI キーワード
- ClientWrkStnName
- 同等の IBM® Data Server Provider for .NET 接続ストリング・キーワード
- ClientWorkstationName
- IBM データ・サーバー・ドライバー構成ファイル (db2dsdriver.cfg) 構文
- <parameter name="ClientWorkstationName" value="workstation_name"/>
- デフォルト設定:
- ClientWorkstationName キーワードを指定しない場合は、ホスト名を使用する試みが行われます。
ホスト名は gethostname() 関数を呼び出すことによって取得されます。
ホスト名が構成されていない場合、もしくは gethostname() 関数呼び出し中にエラーが発生した場合、ClientWorkstationName キーワードの値はデータベース・サーバーに送信されません。
- 同等の環境属性または接続属性:
- SQL_ATTR_INFO_WRKSTNNAME
- 使用上の注意:
- CLI ドライバーおよび IBM Data Server Provider for .NET では、ClientWorkstationName キーワードの値に 255 文字までの制限があります。
ただし、データベース・サーバーにより、値の長さに関する別の制限が適用され、値が切り捨てられることがあります。
DB2® for i
V6R1 以降のサーバーは 255 文字までの長さをサポートします。
DB2 for z/OS® サーバーの場合、
ClientWorkstationName キーワードにより、CURRENT CLIENT_WRKSTNNAME 特殊レジスターが設定されます。
- DB2 for z/OS バージョン 10 以前のサーバーの場合、サポートされるのは 18 文字までです。
- 新機能モード (NFM) の DB2 for z/OS バージョン
11 サーバーでは、CURRENT CLIENT_WRKSTNNAME 特殊レジスターでサポートされる文字の長さは 255 文字までです。
DB2 for z/OS バージョン 9 以前のサーバーへの送信時にデータが正確に変換されるようにするため、文字 A から Z、数字 0 から 9、下線 (_) またはピリオド (.) のみを使用してください。ClientWorkstationName キーワードの値をサーバーに送信しない場合、次のように
'NODEFAULT' 値を指定します。
<parameter name="ClientWorkstationName" value="'NODEFAULT'"/>
'NODEFAULT' 値を DB2ConnectionStringBuilder.ClientWorkstationName プロパティーで指定することはできません。
トランザクションの開始後に ClientWorkstationName キーワードを変更しても、次のトランザクションの開始まで有効になりません。
DB2 for z/OS サーバーへの接続では、自動クライアント・リルート (ACR) フィーチャーおよびワークロード・バランシング (WLB) フィーチャーが有効になっている場合、接続フェイルオーバーの際にそのサーバーに ClientWorkstationName キーワード値が送信されます。