DB2 10.5 for Linux, UNIX, and Windows

DB2Connection.ClientApplicationInformation property

Gets or sets the client application name.

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

Syntax

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

Property value

The IBM® Data Server Provider for .NET has limit of 255 characters for the ClientApplicationInformation 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 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 default value of the ClientApplicationInformation property is an empty string ("").

The ClientApplicationInformation property value in the DB2Connection class is stored in the DB2 special register (CURRENT CLIENT_APPLNAME).

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

DB2 for z/OS servers use the ClientAccountingInformation property value in the DB2Connection class to classify work.

You can obtain the default value that is set by the client on the DB2 for z/OS server when the following conditions are met:

You have not explicitly set the client application name registry value.
The enableDefaultClientInfo IBM data server driver configuration keyword is set to True.

The default value is the current application process name