IBM Data Server Driver for JDBC and SQLJ 属性 Db2 for z/OS

部分 IBM Data Server Driver for JDBC and SQLJ 属性仅适用于 Db2 for z/OS 服务器。

以下列表包括的属性为 IBM Data Server Driver for JDBC and SQLJ ：

accountingInterval

指定 Db2 会计记录是在提交点生成还是在数据源物理连接终止时生成。此属性的数据类型为 String。

如果 accountingInterval 的值为“COMMIT”，且没有打开或持有的光标，则 Db2 每当应用程序提交工作时，都会写入会计记录。如果 accountingInterval 的值为“COMMIT”，并且应用程序在挂起游标打开时执行提交操作，那么记帐时间间隔跨越该提交点。记帐时间间隔也将在下一个有效记帐时间间隔结束点结束。如果 accountingInterval 的值不是“COMMIT”，那么会在与数据源的物理连接终止时生成记帐记录。

accountingInterval 属性为底层的 RRSAF 登录调用设置 accounting-interval 参数。如果子系统参数 ACCUMACC 的值不是 NO，那么 ACCUMACC 值将覆盖 accountingInterval 设置。

accountingInterval 属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。 accountingInterval 属性不适用于 CICS® 或 IMS 下的连接，也不适用于Java存储过程。

accountingInterval 属性覆盖 db2.jcc.accountingInterval 配置属性。

charOutputSize

指定INOUT或OUT存储过程参数的最大字节数，这些参数注册为 Types.CHAR charOutputSize 仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。

由于在运行时无法获得存储过程INOUT和OUT参数的描述信息，因此默认情况下， IBM Data Server Driver for JDBC and SQLJ 将INOUT或OUT参数中每个字符的最大长度设置为32767。对于具有许多 Types.CHAR 参数的存储过程，此最大设置可能会导致分配的存储比必要存储更多。

要更有效地使用存储，请将 charOutputSize 设置为任何 Types.CHAR INOUT 或 OUT 参数的最大预期长度。

charOutputSize 属性对注册为 Types.VARCHAR 或 Types.LONGVARCHAR的 INOUT 或 OUT 参数不起作用。驱动程序为 Types.VARCHAR 和 Types.LONGVARCHAR 参数使用缺省长度 32767。

在选择 charOutputSize 的值之前，需要考虑字符转换期间的扩展可能性。因为 IBM Data Server Driver for JDBC and SQLJ 没有关于用于输出参数值的、服务器端CCSID的信息，驱动程序以 UTF-8 Unicode格式请求存储过程输出数据。 charOutputSize 值需要是参数值转换为 UTF-8 Unicode 后需要的最大字节数。 UTF-8 Unicode 字符最多需要 3 个字节。（例如，欧元符号是一个 3 字节的 UTF-8 字符）。要确保 charOutputSize 的值足够大，如果您没有输出数据的相关信息，请将 charOutputSize 设置为最大 CHAR 参数的定义长度的三倍。

clientApplcompat

对于连接 Db2 12 for z/OS 数据服务器，功能级别为 V12R1M501 或更高版本，将特定实例的功能 IBM Data Server Driver for JDBC and SQLJ 的功能级别设置为小于或等于数据服务器的功能级别。

例如，假设驱动程序包的实例为 IBM Data Server Driver for JDBC and SQLJ 的驱动程序包与APPLCOMPAT值 V12R1M501 绑定。一些使用驱动程序实例的应用程序只需要函数级别 V12R1M500 中的功能。您可以将这些应用程序的 clientApplcompat 设置为 V12R1M500，以仅使用 V12R1M500 函数级别的功能。

如果驱动程序包的 APPLCOMPAT 值为 V12R1M500 或更低，并且未设置 clientApplcompat，那么 APPLCOMPAT 设置将确定客户机应用程序可以使用的一组功能。

如果驱动程序包的 APPLCOMPAT 值为 V12R1M501 或更高，那么可以选择设置 clientApplcompat。但是，如果未设置 clientApplcompat ，且 IBM Data Server Driver for JDBC and SQLJ 不支持APPLCOMPAT绑定选项值的 Db2 12 for z/OS 包的APPLCOMPAT绑定选项值。

更多信息，请参阅 “设置数据服务器客户端和驱动程序的兼容性级别 ”。

clientProgramId

指定可用于标识最终用户的客户机程序标识的值。此属性的数据类型为 String ，长度为80字节。如果程序标识值小于 80 字节，那么必须使用空格填充该值。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。

clientProgramName

指定一个应用程序名称，用于将数据服务器正在处理的应用程序与分布式应用程序的名称相关联。 Db2 for z/OS 数据服务器正在处理的应用程序与分布式应用程序的名称相关联。此属性的数据类型为 String。最大长度为20字节。如果该值为 null ，则 IBM Data Server Driver for JDBC and SQLJ 提供了 db2jcc_applicationapplication-name 的值，其中 application-name 是 CURRENT CLIENT_APPLNAME 特殊寄存器的值。

重要提示：使用IFCID 411监控应用程序时，每个应用程序的名称不能超过6000个。如果超出此限制， Db2 for z/OS 发送邮件至 DSNL030I ，并附上原因代码 00D3105D ，同时停止收集任何新应用程序名称的统计数据，直到 DDF 重启。为了在监控远程用户统计信息时获得最佳效果，请使用 CURRENT CLIENT_CORR_TOKEN 特殊寄存器来识别各个连接。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型4连接。

clientUser

指定使用连接的应用程序所代表的用户名称。该值存储在 Db2 特殊寄存器 CURRENT CLIENT_USERID 中。此属性的数据类型为 String。最大长度为128字节。

Java空字符串（""）对于 clientUser 值是有效的，但Java null 值无效。

重要提示：使用IFCID 412监控应用程序时，唯一用户ID值限制为6000个。如果超出此限制， Db2 for z/OS 发送邮件至 DSNL030I ，并附上原因代码 00D3105E ，同时停止收集任何新应用程序名称的统计数据，直到 DDF 重启。为了在监控远程用户统计信息时获得最佳效果，请使用 CURRENT CLIENT_CORR_TOKEN 特殊寄存器来识别各个连接。

clientWorkstation

指定运行使用连接的应用程序的计算机的主机名。该值存储在 Db2 特殊寄存器 CURRENT CLIENT_WRKSTNNAME 中。此属性的数据类型为 String。最大长度为 255 字节。

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

currentLocaleLcCtype

指定用于执行 SQL 语句的 LC_CTYPE 语言环境，这些 SQL 语句使用引用语言环境的内置函数。此属性的数据类型为 String。如果设置了 currentLocaleLcCtype ，则 IBM Data Server Driver for JDBC and SQLJ 将数据服务器上的当前区域设置LC_CTYPE特殊寄存器设置为属性值。 currentLocaleLcCtype 属性没有缺省值。

currentLocaleLcCtype 属性只能在连接开始时设置，并且在连接处于活动状态时无法更改。

currentSQLID

currentSQLID 属性指定以下信息：

授权标识，用于对动态准备的 CREATE、GRANT和 REVOKE SQL 语句进行授权检查。
由动态发出的 CREATE 语句创建的表空间、数据库、存储器组或同义词的所有者。
动态 SQL 语句中指定的所有表、视图、别名和索引名的隐式限定符。

currentSQLID 属性在服务器上CURRENT SQLID特殊寄存器中设置值 Db2 for z/OS 服务器上。如果未设置 currentSQLID 属性，那么缺省模式名称是 CURRENT SQLID 专用寄存器中的值。

enableMultiRowInsertSupport

指定 IBM Data Server Driver for JDBC and SQLJ 在目标数据服务器是支持多行插入的 Db2 for z/OS 支持多行插入的服务器。批处理操作必须是带有参数标记的 PreparedStatement 调用。此属性的数据类型为布尔值。缺省值为 true。

在连接期间，不能更改 enableMultiRowInsertSupport 值。如果在批处理中执行 INSERT FROM SELECT 语句，那么必须将 enableMultiRowInsertSupport 属性设置为 false。否则，驱动程序会生成 BatchUpdateException 错误。

enableT2zosLBF

指定是否对使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接从本地 Db2 for z/OS 数据服务器。此属性的数据类型是 int。必须使用以下某个属性值：

com.ibm.db2.jcc.DB2BaseDataSource.NOT_SET (0) or not specified

这是缺省设置。

为了连接 Db2 for z/OS 数据服务器，在版本10转换模式下，指定有限块获取不用于从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的本地表中检索数据。
用于连接 Db2 for z/OS 数据服务器，指定使用有限块获取从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的本地表中检索数据。

com.ibm.db2.jcc.DB2BaseDataSource.YES (1)

指定使用有限块获取从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的本地表中检索数据。

如果将此属性设置为1，并且 IBM Db2 Analytics Accelerator for z/OS 在光标重用期间可能也需要打开，则需要将配置属性 db2.jcc.enableT2zosLBFSwitchWithIDAA 设置为1。

com.ibm.db2.jcc.DB2BaseDataSource.NO (2)

指定当从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的本地表中检索数据时，不使用有限块获取。

enableT2zosLBF 属性适用于 Db2 for z/OS 版本10新功能模式或更高版本的数据服务器。 enableT2zosLBF 属性不适用于检索存储过程结果集。

enableT2zosLBFSPResultSets

指定是否对使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的连接使用有限块获取，以便从本地 Db2 for z/OS 数据服务器上。此属性的数据类型为 int。以下是属性的可能值：

com.ibm.db2.jcc.DB2BaseDataSource.YES (1) or com.ibm.db2.jcc.DB2BaseDataSource.NOT_SET (0): 指定使用有限块获取从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的存储过程结果集中检索数据。此值是缺省值。
com.ibm.db2.jcc.DB2BaseDataSource.NO (2): 指定在从使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接的存储过程结果集中检索数据时，不使用有限块获取。

enableT2zosLBFSPResultSets 属性适用于 Db2 for z/OS 版本10新功能模式或更高版本的数据服务器。

enableXACleanTransaction

指定是否在 XA 结束时复位会话数据。 enableXACleanTransaction 的数据类型为布尔值。该属性的可能值包括以下布尔值：

true: 启用清洁事务模式。所有数据库资源（如游标和 DGTT）都将隐式关闭并在 XA_END 上删除。
false: 启用脏事务模式。此值是缺省值。会话数据在 XA 结束时不会重置，并且在事务之间持续存在。

extendedTableInfo

extendedTableInfo 属性指定是否从 DatabaseMetaData.getTables 方法调用返回有关扩展表类型的信息。当前存在一个扩展表类型：ACCEL-ONLY TABLE。

com.ibm.db2.jcc.DB2BaseDataSource.NO (2) or com.ibm.db2.jcc.DB2BaseDataSource.NOT_SET (0)

DatabaseMetaData.getTables 方法返回的结果集不包含扩展表类型的列。

仅当在类型参数值中显式指定了“TABLE”时，才会返回扩展表类型的行。在这种情况下，扩展表类型在结果集的 TABLE_TYPE 列中列示为 TABLE。

com.ibm.db2.jcc.DB2BaseDataSource.YES (1)

DatabaseMetaData.getTables 方法返回的结果集包含扩展表类型的行和列。以下列表更详细地描述了结果集：

结果集包含在 DatabaseMetaData.getTables 的结果集中始终返回的列之后的这些额外列：

表 1. 额外返回的列 DatabaseMetaData.getTables
列名	数据类型	描述
TEMPORAL_TABLE_TYPE	字符串	包含临时表的类型。以下显示了临时表的可能值： SYSTEM 系统周期时态表。 APPLICATION 应用程序周期时态表。 BITEMPORAL 双时态表。 Empty string 不是时间表。此行用于连接 Db2 for z/OS 版本10或更高版本。
IS_ACCELERATED	字符串	指示表是否为加速表。可能的值为 YES 或 NO。此行用于连接 Db2 for z/OS 版本10或更高版本。
ACCEL_ARCHIVE_STATUS	字符串	包含加速器数据库中的表的归档状态。请参阅 SYSACCEL.SYSACCELERATEDTABLES 表格中ARCHIVE列的描述，了解可能的值及其含义。此行用于连接 Db2 for z/OS 版本10或更高版本。
IS_ARCHIVE_ENABLED	字符串	指示表是否启用了归档。可能的值为 YES 或 NO。此行用于连接 Db2 for z/OS 版本11或更高版本。

在下列情况下，将返回扩展表类型的行：
- 通过在类型参数值中指定 null 来隐式请求所有表类型。
- 在类型参数值中显式指定扩展表类型名称。
  在这种情况下，扩展表类型由其扩展表类型名称列示在结果集的 TABLE_TYPE 列中。

jdbcCollection

指定运行时实例使用的软件包的集合ID。 IBM Data Server Driver for JDBC and SQLJ 在运行时使用的包的集合ID。 jdbcCollection 的数据类型为字符串。缺省值为 NULLID。

此属性与 DB2Binder -collection 选项一起使用。 DB2Binder 实用程序必须使用与值匹配的值，在服务器上包含有界 IBM Data Server Driver for JDBC and SQLJ 数据包，使用与 jdbcCollection 值匹配的 -collection 值。

jdbcCollection 设置不会确定用于 SQLJ 应用程序的集合。对于 SQLJ，集合由 SQLJ 定制程序的 -collection 选项确定。

jdbcCollection 设置不适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。

keyUsage

keyUsage 属性仅用于从 WINDOWS -MY 密钥库类型中选择基于 keyUsage 的证书的客户机证书。 PKI 卡支持 WINDOWS -MY 密钥库类型和 WINDOWS-ROOT 信任库类型。它不适用于服务器证书认证的服务器证书。如果 DataSource 或 Connection 对象配置了 securityMechanism 值 TLS_CLIENT_CERTIFICATE_SECURITY (18)，则 keyUsage 将应用于 Connection 对象以选择客户证书。

如果 DataSource 或 Connection 对象未配置 securityMechanism 值 TLS_CLIENT_CERTIFICATE_SECURITY (18)，则驱动程序会忽略 keyUsage 属性，并使用 SSL 连接的默认设置。有关 keyUsage 属性的可能值，请参见下表。

表 2. keyUsage 常量
证书 keyUsage 常量	值
`com.ibm.db2.jcc.DB2BaseDataSource.NOT_SET`	0
`com.ibm.db2.jcc.DB2BaseDataSource.digitalSignature`	1
`com.ibm.db2.jcc.DB2BaseDataSource.nonRepudiation`	2
`com.ibm.db2.jcc.DB2BaseDataSource.keyEncipherment`	4
`com.ibm.db2.jcc.DB2BaseDataSource.dataEncipherment`	8
`com.ibm.db2.jcc.DB2BaseDataSource.keyAgreement`	16
`com.ibm.db2.jcc.DB2BaseDataSource.keyCertSign`	32
`com.ibm.db2.jcc.DB2BaseDataSource.cRLSign`	64
`com.ibm.db2.jcc.DB2BaseDataSource.encipherOnly`	128
`com.ibm.db2.jcc.DB2BaseDataSource.decipherOnly`	256

此整数属性的缺省值为 0 (NOT SET)。 keyUsage 常量（KeyUsage_ALL，-1 除外）是不断递增的数字。要在 keyUsage 属性中指定多个 keyUsage 组件（由其对应的 keyUsage 常量指定），请使用数字相加来组合首选的 keyUsage 常量。例如，假设需要此跟踪规范：

(digitalSignature |
 nonRepudiation |
 keyEncipherment | 
 dataEncipherment | 
 keyAgreement | 
 cRLSign)

您需要将 keyUsage 设置为这些常量的整数值之和：

1 + 2 + 4 + 16 + 32 + 64 = 119

因此，keyUsage 必须设置为 119 才能启用这些 keyUsage 组件。

maxConnCachedParamBufferSize

指定用于高速缓存 PreparedStatement 对象的输入参数值的内部缓冲区的最大大小。缓冲区缓存本地代码端从驱动程序的Java代码端传递的 IBM Data Server Driver for JDBC and SQLJ 类型2连接的值。缓冲区被所有 PreparedStatement 对象用于 Connection。缺省值为 1048576 (1 MB)。缺省值必须对于大多数用户够用。如果驱动程序实例下运行的许多应用程序具有大量输入参数或大输入参数的 PreparedStatement 对象，请将 maxConnCachedParamBufferSize 设置为更大的值。 maxConnCachedParamBufferSize 值必须大于 Connection 的所有输入参数数据的最大大小。但是，您还需要考虑设置 maxConnCachedParamBufferSize 值时可用的连接总数和最大内存量。

缓冲区在 Connection 的生命周期内一直存在，除非它达到最大大小。如果发生这种情况，每次调用本机代码时都会释放缓冲区。 Java代码端的相应缓冲区在 PreparedStatement.clearParameters 和 PreparedStatement.close 调用时释放。如果应用程序调用 PreparedStatement.clearParameters，并且缓冲区未达到最大大小，那么不会清除缓冲区。

maxRowsetSize

当 IBM Data Server Driver for JDBC and SQLJ 使用多行FETCH进行游标操作时，此属性的数据类型为 int。缺省值为 32767。

maxRowsetSize 属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。

pkList

指定在建立与数据源的 JDBC 或 SQLJ 连接时，用于底层 RRSAF CREATE THREAD 调用的程序包列表。 pkList IBM Data Server Driver for JDBC and SQLJ 属性仅适用于 Db2 for z/OS。

如果没有为 SQLJ 程序或 JDBC 驱动程序绑定计划，请指定此属性。如果指定此属性，那么不指定 planName。

建议：使用 pkList 而不是 planName。

以下是程序包列表的格式：

pkList 属性覆盖 db2.jcc.pkList 配置属性的值。如果未指定 pkList、planName 和 db2.jcc.pkList，那么 pkList 的值为 NULLID.*。

planName

指定一个 Db2 计划名称，用于在建立 JDBC 或SQLJ连接到数据源时调用RRSAF的CREATE THREAD。 planName 仅适用于 IBM 2型连接 Data Server Driver for JDBC and SQLJ。

如果没有为 SQLJ 程序和 JDBC 驱动程序包绑定计划，请指定此属性。如果指定此属性，那么不指定 pkList。

planName 属性覆盖 db2.jcc.planName 配置属性的值。如果未指定 pkList、 planName 和 db2.jcc.planName ，则使用NULLID。* 用作基础CREATE THREAD调用的包列表。

queryAcceleration

指定要用于 CURRENT QUERY ACCELERATION 专用寄存器的值。此属性的数据类型为 String。可能的值包括：

NONE: 指定不执行查询加速。
ENABLE: 规定只有在 Db2 for z/OS 确定这样做有利时，才加速查询。如果在查询运行时出现加速器故障，或者加速器返回错误，则 Db2 for z/OS 向应用程序返回SQL错误。
ENABLE WITH FAILBACK: 规定只有在 Db2 for z/OS 确定这样做有利时，才加速查询。如果在查询的PREPARE或首次OPEN期间油门踏板返回错误，则 Db2 for z/OS 在没有加速器的情况下执行查询。如果在FETCH或后续OPEN期间油门踏板返回错误，则 Db2 for z/OS 将错误反馈给用户，不执行查询。
ELIGIBLE: 指定查询条件符合加速条件时，加速查询。 Db2 for z/OS 不使用成本信息来确定是否加速查询。不符合加速条件的查询由 Db2 for z/OS。如果在查询运行时出现加速器故障，或者加速器返回错误，则 Db2 for z/OS 向应用程序返回SQL错误。
ALL: 指定查询条件符合加速条件时，加速查询。 Db2 for z/OS 不使用成本信息来确定是否加速查询。不符合加速条件的查询不会被 Db2 for z/OS ，并返回SQL错误。如果在查询运行时出现加速器故障，或者加速器返回错误，则 Db2 for z/OS 向应用程序返回SQL错误。

reportLongTypes

指定 DatabaseMetaData 方法是否将 LONG VARCHAR 和 LONG VARGRAPHIC 列数据类型报告为长整型数据类型。此属性的数据类型是短整型。可能的值包括：

com.ibm.db2.jcc.DB2BaseDataSource.NO (2) or com.ibm.db2.jcc.DB2BaseDataSource.NOT_SET (0): 指定返回 LONG VARCHAR 或 LONG VARGRAPHIC 列信息的 DatabaseMetaData 方法；这些方法返回结果集中 DATA_TYPE 列中的 java.sql.Types.VARCHAR 和 TYPE_NAME 列的 VARGRAPHIC。此值是 Db2 for z/OS 版本9或更高版本。
com.ibm.db2.jcc.DB2BaseDataSource.YES (1): 指定返回 LONG VARCHAR 或 LONG VARGRAPHIC 列信息的 DatabaseMetaData 方法；这些方法返回结果集中 DATA_TYPE 列的 java.sql.Types.LONGVARCHAR。该方法还会在结果集的 TYPE_NAME 列中返回 LONG VARCHAR 或 LONG VARGRAPHIC。

sendCharInputsUTF8

指定是否 IBM Data Server Driver for JDBC and SQLJ 将字符输入数据转换为数据库服务器的CCSID， Db2 for z/OS 数据库服务器，还是以 UTF-8 编码发送数据，由数据库服务器进行转换。 sendCharInputsUTF8 适用于 IBM 2型连接 Data Server Driver for JDBC and SQLJ。此属性的数据类型为 int。如果此属性也设置在驱动程序级别 (db2.jcc.sendCharInputsUTF8)，那么此值将覆盖驱动程序级别值。

以下显示了属性的可能值：

com.ibm.db2.jcc.DB2BaseDataSource.NO (2)

将字符输入数据转换为目标编码，然后再将数据发送到 IBM Data Server Driver for JDBC and SQLJ 在将字符输入数据发送到数据库服务器之前，将其转换为目标编码。 Db2 for z/OS 数据库服务器。 com.ibm.db2.jcc.DB2BaseDataSource.NO 是默认值。

com.ibm.db2.jcc.DB2BaseDataSource.YES (1)

指定 IBM Data Server Driver for JDBC and SQLJ 以 UTF-8 编码将字符输入数据发送到 Db2 for z/OS 数据库服务器。数据库服务器将数据从 UTF-8 编码转换为目标 CCSID。

仅当Java SDK转换为目标CCSID时出现字符转换问题时，才指定 com.ibm.db2.jcc.DB2BaseDataSource.YES。最常见的问题是，当您使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接将Unicode换行符（ U+000A ）插入到CCSID为37的表格列中，然后从非 z/OS 客户端中检索该数据时，会发生这种情况。如果Java SDK在将字符插入列时进行了转换，则换行符将转换为EBCDIC新行符X'15'。然而，在检索过程中，某些在 z/OS 以外操作系统上运行的Java SDK会将X'15'字符转换为Unicode换行字符（ U+0085 ），而不是换行符（ U+000A ）。下一行字符会导致某些 XML 解析器出现异常行为。如果您将 sendCharInputsUTF8 设置为 com.ibm.db2.jcc.DB2BaseDataSource.YES ， Db2 for z/OS 数据库服务器在将 U+000A 字符插入到列中时将其转换为EBCDIC换行符X'25'。因此，字符总是被检索为换行符。

将数据转换为数据库服务器上的目标CCSID可能会导致 IBM Data Server Driver for JDBC and SQLJ 比驱动程序转换时占用更多的内存。驱动程序分配内存以将字符数据从源编码转换为发送到数据库服务器的数据的编码。驱动程序为发送到表列的字符数据分配的空间量基于数据的最大长度。 UTF-8 数据的每个字符最多需要 3 个字节。因此，如果驱动程序将 UTF-8 数据发送到数据库服务器，那么驱动程序需要分配输入数据中最大字符数的三倍。如果驱动程序执行转换，并且目标 CCSID 是单字节 CCSID，那么驱动程序需要仅分配输入数据中的最大字符数。

sessionTimeZone

指定 CURRENT SESSION TIME ZONE 专用寄存器的设置。此属性的数据类型为 String。

sessionTimeZone 值是格式为 sth:tm 的时区值。格式中的 s 是符号，th 是时区小时，tm 是时区分钟。有效值的范围是 -12:59 到 +14:00。

sqljEnableClassLoaderSpecificProfiles

指定是否 IBM Data Server Driver for JDBC and SQLJ 是否允许在多个 J2EE 应用程序（.ear）文件中使用和加载具有相同Java名称的SQLJ配置文件。此属性的数据类型为布尔值。缺省值为 false。 sqljEnableClassLoaderSpecificProfiles 属性是 dataSource 属性。此属性主要用于 WebSphere® Application Server。

ssid

指定使用 IBM Data Server Driver for JDBC and SQLJ 类型 2 连接) 建立连接的本地 Db2 for z/OS 子系统的名称。此属性的数据类型为 String。

ssid 属性将覆盖 db2.jcc.ssid 配置属性。

ssid 属性可以是本地子系统的子系统名称，也可以是组附件名称或子组附件名称。

通过指定单个本地子系统的名称，可以使用 IBM Data Server Driver for JDBC and SQLJ 类型2连接将单个LPAR上的多个子系统作为本地子系统进行访问。

如果数据共享组成员失败，那么组附件名称或子组附件名称的规范允许进行故障转移处理。如果 Db2 应用程序所连接的子系统发生故障，连接将终止。然而，当新连接使用该组附件名称或子组附件名称时， Db2 for z/OS 使用组或子组连接处理来寻找一个 Db2 子系统进行连接。

ssid 属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型2连接。

sslClientCertificateAlias

指定客户端为 Java 密钥存储中的证书指定的别名。该别名对应的证书用于 SSL 连接。

该属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型 4 连接到 Db2 for z/OS ，当安全机制值为 TLS_CLIENT_CERTIFICATE_SECURITY (18) 时。

db2.jcc.override.sslClientCertificationAlias 配置属性会覆盖 Connection 或 DataSource 对象的 sslClientCertificationAlias 属性。

sslKeyStoreLocation

指定客户端上Java KeyStore 的完整路径名，其中包含SSL连接的客户端证书。客户机证书仅用于在相互认证或客户机证书安全性期间标识客户机。

只有当属性设置为 true 和设置为 18（TLS_CLIENT_CERTIFICATE_SECURITY）时，才会使用该选项。 IBM Data Server Driver for JDBC and SQLJ 只有当 sslConnection 属性设置为 true 且 securityMechanism 设置为 18（TLS_CLIENT_CERTIFICATE_SECURITY）时，才会使用该选项。

如果设置了 sslKeyStoreLocation ，且 sslConnection 设置为true，则 IBM Data Server Driver for JDBC and SQLJ 使用 sslKeyStoreLocation 值，而不是 javax.net.ssl.keyStore Java属性中的值。

sslKeyStoreLocation 的缺省值由 db2.jcc.sslKeyStoreLocation 配置属性提供。如果还未指定 db2.jcc.sslKeyStoreLocation 配置属性，那么 sslKeyStoreLocation 的缺省值为 null。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 4型连接。

sslKeyStorePassword

指定客户端上Java KeyStore 的密码，其中包含SSL连接的客户端证书。

如果设置了 sslKeyStorePassword ，且 sslConnection 设置为true，则 IBM Data Server Driver for JDBC and SQLJ 使用 sslKeyStorePassword 值，而不是 javax.net.ssl.keyStorePassword Java属性中的值。

sslKeyStorePassword 的缺省值由 db2.jcc.sslKeyStorePassword 配置属性提供。如果还未指定 db2.jcc.sslKeyStorePassword 配置属性，那么 sslKeyStorePassword 的缺省值为 null。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 4型连接。

sslKeyStoreType

指定客户端上Java KeyStore 的类型，其中包含SSL连接的客户端证书。

如果设置了 sslKeyStoreType ，且 sslConnection 设置为true，则 IBM Data Server Driver for JDBC and SQLJ 使用 sslKeyStoreType 值，而不是 javax.net.ssl.keyStoreType Java属性中的值。

sslKeyStoreType 的缺省值由 db2.jcc.sslKeyStoreType 配置属性提供。如果还未指定 db2.jcc.sslKeyStoreTypeconfiguration 配置属性，那么 sslKeyStoreType 的缺省值为 null。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 4型连接。

useRowsetCursor

指定是否 IBM Data Server Driver for JDBC and SQLJ 如果数据源支持多行 FETCH，则始终对可滚动光标使用多行 FETCH。此属性的数据类型为布尔值。

此属性仅适用于 IBM Data Server Driver for JDBC and SQLJ 类型4连接，或 IBM Data Server Driver for JDBC and SQLJ 类型2连接。如果未设置 enableRowsetSupport 属性，那么 useRowsetCursor 的缺省值为 true。如果设置了 enableRowsetSupport 属性，那么不会使用 useRowsetCursor 属性。

使用 JDBC 1 技术执行定位更新或删除操作的应用程序必须将 useRowSetCursor 设置为 false。如果应用程序 IBM Data Server Driver for JDBC and SQLJ 使用多行FETCH。