DB2®ConnectionStringBuilder.ClientApplicationName property

Gets or sets the value of a client application name that is sent to a database.

Namespace:
IBM.Data.DB2
Assembly:
IBM.Data.DB2 (in IBM.Data.DB2.dll)

Syntax

[Visual Basic]
Public Property ClientApplicationName As String
[C#]
public string ClientApplicationName {get; set;}
[C++]
public: __property String* get_ClientApplicationName();
public: __property void set_ClientApplicationName(String*);
[JScript]
public function get ClientApplicationName() : String;
public function set ClientApplicationName(String);

Property value

 The IBM® Data Server Provider for .NET has limit of 255 characters for the ClientApplicationName property.

Database servers enforce different limitation in the length of the value and can truncate it. Note the following conditions:
  • Db2® for z/OS® Version 11 servers in new function mode (NFM) support a length of up to 255 characters.
  • Db2 for z/OS Version 10 and earlier servers support a length of up to 32 characters.
  • Db2 for IBM i V6R1 and later servers support a length of up to 255 characters.
To ensure that the data is converted correctly when transmitted to Db2 for z/OS Version 9 and earlier servers, use only the characters A-Z and 0-9 and the underscore (_) or period (.).

The ClientApplicationName property value in the DB2ConnectionStringBuilder class is stored in the Db2 special register (CURRENT CLIENT_APPLNAME).

The ClientApplicationName property must be set before the start of a transaction. Changes to the ClientApplicationName property after the start of a transaction do not take effect until the start of the next transaction.