IBM Data Server Driver for JDBC and SQLJ 支持的客户机信息属性

JDBC 4.0 包括客户机信息属性，这些属性包含有关与数据源的连接的信息。 DatabaseMetaData.getClientInfoProperties 方法返回一个客户端信息属性列表，该列表 IBM Data Server Driver for JDBC and SQLJ 支持。

调用 DatabaseMetaData.getClientInfoProperties 时，将返回包含以下列的结果集：
  • 名称
  • MAX_LEN
  • DEFAULT_VALUE
  • 描述

客户信息 属性 支持 Db2 on Linux, UNIX, and Windows systems and Db2 for IBM i

下表列出了 IBM Data Server Driver for JDBC and SQLJ 为 Linux®、UNIX 和 Windows 系统上的 Db2 以及 IBM i 上的 Db2 返回的客户端信息属性值。

表 1. Linux、UNIX 和 Windows 系统上的 Db2 以及 IBM i 上的 Db2 的客户端信息属性值
名称 MAX_LEN（字节） DEFAULT_VALUE 描述
ClientAccountingInformation 255 空字符串 来自为连接指定的客户机信息的记帐字符串值。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_ACCTNG中。
ApplicationName 255 空字符串 当前正在使用连接的应用程序的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_APPLNAME中。
ClientUser 255 空字符串 正在运行应用程序（使用连接）的用户的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_USERID中。
ClientHostname 255

从版本 3.68 或 4.18 的 IBM Data Server Driver for JDBC and SQLJ ，如果 ClientHostname 被设置为IP地址以外的任何值，则不会向数据服务器发送任何值。

 正在运行应用程序（使用连接）的计算机的主机名。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_WRKSTNNAME中。

客户信息 属性 支持 IBM Data Server Driver for JDBC and SQLJ 类型 4 连接到 Db2 for z/OS

下表列出了客户端信息属性值，这些值 IBM Data Server Driver for JDBC and SQLJ 当连接使用类型4连接时， Db2 for z/OS® 时，连接使用类型4连接。

表 2. 客户信息 4类连接的物业价值 Db2 for z/OS
名称 MAX_LEN（字节） DEFAULT_VALUE 描述
ClientAccountingInformation 255 格式为 JCCversionclient-ip 的字符串，其中 version 是驱动程序版本， client-ip 是客户机的 IP 地址。 来自为连接指定的客户机信息的记帐字符串值。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_ACCTNG中。
ApplicationName 255 字符串“db2jcc_application”。 当前正在使用连接的应用程序的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_APPLNAME.1中
ClientCorrelationToken 255 数据服务器生成的 LUWID（逻辑工作单元标识）。 允许您跨企业关联业务流程的唯一值。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_CORR_TOKEN中。 客户关联标记值可在 Db2 跟踪的会计相关记录中，以及-DISPLAY THREAD命令输出中。
ClientUser 128 建立连接时指定的用户标识。 正在运行应用程序（使用连接）的用户的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_USERID.2 中
ClientHostname 255 版本 3.68 或 4.18 之前， IBM Data Server Driver for JDBC and SQLJ 字符串“ db2jcc_local ”。

对于版本 3.68 或 4.18 ，或更高版本的 IBM Data Server Driver for JDBC and SQLJ ，如果 ClientHostname 被设置为IP地址以外的任何值，则不会向数据服务器发送任何值。

 正在运行应用程序（使用连接）的计算机的主机名。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_WRKSTNNAME中。
注：
  1. Db2 for z/OS IFCID 411用于收集应用程序名称统计信息的跟踪仅限于6000个唯一应用程序名称。 如果超出此限制， Db2 数据服务器会发出错误 DSNL030I ，并附上原因代码 00D3105D ，同时停止收集任何新应用程序名称的统计数据，直到分布式数据设施（DDF）重启。
  2. Db2 for z/OS 用于收集用户ID统计信息的IFCID 412跟踪仅限于6000个唯一用户ID。 如果超出此限制， Db2 数据服务器将发出错误 DSNL030I ，并附上原因代码 00D3105E ，同时停止收集任何新用户ID的统计数据，直到分布式数据设施（DDF）重启。
提示 ：当客户信息属性设置为 IBM Data Server Driver for JDBC and SQLJ 类型4连接到 Db2 for z/OS ，属性值将在以下时间生效：
  • 如果驱动程序发送一个 Connection.setClientInfo 方法作为DDM EXCSQLIMM命令，属性值将在数据服务器处理后立即生效。
  • 如果驱动程序发送一个 Connection.setClientInfo 方法作为DDM EXCSQLSET命令，则属性值将在连接的下一个事务中生效。 数据服务器在提交后执行第一个SQL语句之前处理该命令。

客户信息 属性 支持 IBM Data Server Driver for JDBC and SQLJ 类型 2 连接 Db2 for z/OS

下表列出了客户端信息属性值，这些值 IBM Data Server Driver for JDBC and SQLJ 当连接使用类型2连接时， Db2 for z/OS 时，连接使用类型2连接。

表 3. 客户信息 2型连接的物业价值 Db2 for z/OS
名称 MAX_LEN（字节） DEFAULT_VALUE 描述
ClientAccountingInformation 255 空字符串。 来自为连接指定的客户机信息的记帐字符串值。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_ACCTNG中。
ApplicationName 255 字符串“db2jcc_application”。 当前正在使用连接的应用程序的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_APPLNAME.1中
ClientCorrelationToken 255 数据服务器生成的 LUWID（逻辑工作单元标识）。 允许您跨企业关联业务流程的唯一值。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_CORR_TOKEN中。 客户关联标记值可在 Db2 跟踪的会计相关记录中，以及-DISPLAY THREAD命令输出中。
ClientUser 128 为连接指定的用户标识。 如果没有指定用户ID，则使用 RACF®。 正在运行应用程序（使用连接）的用户的名称。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_USERID.2 中
ClientHostname 255 字符串“RRSAF”。

对于版本 3.68 或 4.18 ，或更高版本的 IBM Data Server Driver for JDBC and SQLJ ，如果 ClientHostname 被设置为IP地址以外的任何值，则不会向数据服务器发送任何值。

 正在运行应用程序（使用连接）的计算机的主机名。 该值存储在 Db2 特殊寄存器CURRENT CLIENT_WRKSTNNAME中。
注：
  1. Db2 for z/OS 用于监控应用程序名称的IFCID 411的跟踪限制为6000个唯一应用程序名称。 如果超出此限制， Db2 数据服务器会发出错误 DSNL030I ，并附上原因代码 00D3105D ，同时停止收集任何新应用程序名称的统计数据，直到分布式数据设施（DDF）重启。
  2. Db2 for z/OS 用于监控用户ID的IFCID 412的跟踪记录仅限于6000个唯一用户ID。 如果超出此限制， Db2 数据服务器将发出错误 DSNL030I ，并附上原因代码 00D3105E ，同时停止收集任何新用户ID的统计数据，直到分布式数据设施（DDF）重启。

客户信息 物业 支持 IBM Informix

下表列出了客户端信息属性值，这些值 IBM Data Server Driver for JDBC and SQLJ 返回的 IBM Informix®

表 4. 客户信息 物业价值 IBM Informix
名称 MAX_LEN（字节） DEFAULT_VALUE 描述
ClientAccountingInformation 199 空字符串 来自为连接指定的客户机信息的记帐字符串值。
ApplicationName 20 空字符串 当前正在使用连接的应用程序的名称。
ClientUser 1024 空字符串 正在运行应用程序（使用连接）的用户的名称。
ClientHostname 20 本地主机的主机名。

对于以 IBM Data Server Driver for JDBC and SQLJ 以 4.18 或 3.68 开头的版本，如果 ClientHostname 被设置为IP地址以外的任何值，则不会向数据服务器发送任何值。

 正在运行应用程序（使用连接）的计算机的主机名。