JDBC 配置脚本

此脚本编制库提供许多脚本过程来管理环境中的 Java™ 数据库连接 (JDBC) 配置。请参阅用来配置 JDBC 设置的脚本的用法信息。您可以单独运行每个脚本,也可以组合许多过程以创建环境的定制自动化脚本。

每个 AdminJDBC 脚本过程都位于 app_server_root/scriptLibraries/resources/JDBC/V70 目录中。

从 V7 开始,Jython 脚本库在服务器作用域为 JDBC 提供程序、JMS 资源和资源提供程序提供了脚本功能。可以在单元、节点或集群级别编写您自己的定制脚本来配置资源。
避免故障 避免故障: 请不要编辑脚本库中的脚本过程。要编写定制脚本库过程,请将 app_server_root/scriptLibraries 目录中的脚本用作 Jython 语法样本。请将定制脚本保存到新的子目录中,以避免覆盖脚本库。gotcha
捷径: 从 FP5 开始,Jython 脚本库在单元、节点、服务器或集群作用域为 JDBC 提供程序、JMS 资源以及资源提供程序提供了脚本功能。资源提供程序包括邮件提供程序、URL 提供程序和资源环境提供程序。不必在特定作用域编写定制脚本来配置资源。
注意: 为打印方便,用法示例脚本和脚本语法被拆分为多行。

作用域参数的格式

作用域格式应用于脚本库中具有该作用域参数的脚本。

在节点、服务器和集群作用域上,单元是可选的。在服务器作用域上,节点是必需的。

可以使用逗号 (,) 或分号 (:) 来定界类型。可以使用小写表示类型(cell=、node=、server= 或 cluster=)。

为了方便发布,下表中的示例分布在多行上。

表 1. 特定作用域的包含路径、配置标识和类型示例. 作用域可以是单元、节点、服务器或集群。
作用域 包含路径 配置标识 类型
单元 /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell 或 cell=myCell
节点 /Cell:myCell/Node:myNode/ 或 /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
Cell=myCell:
Node=myNode
cell=myCell,
node=myNode
Server
/Cell:myCell/Node:
myNode/
Server:myServer/
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
Node=myNode:
Server=myServer
cell=myCell,
Node=myNode,
Server=myServer
集群
/Cell:myCell/
ServerCluster:
myCluster/
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
Cell=myCell:
Cluster=myCluster
cell=myCell,
Cluster=myCluster

createDataSource

此脚本会在配置中创建新数据源。此脚本会返回新数据源的配置标识。

要运行此脚本,请指定节点名、服务器名称、JDBC 提供程序以及数据源名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 2. createDataSource 脚本. 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jdbcProvider 指定相关 JDBC 提供程序的名称。
dsName 指定要分配给新数据源的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 3. 可选属性. 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。  
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description 指定数据源的描述。
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'false']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'false']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。
['statementCacheSize', 5]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
表 4. 可选属性(续). providerType 属性也可用于该脚本。
属性 描述 示例
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Using IBM JCC Driver']

语法

providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSource(nodeName, serverName, 
 jdbcProvider, dsName, attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createDataSource("myNode", "myServer", "myJDBCProvider", 
 "myDataSource")
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSource("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", "MyJDBCDS", 
"authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, 
description='My description', diagnoseConnectionUsage=true, jndiName=myJndiName, 
logMissingTransactionContext=false, manageCachedHandles=false, providerType='DB2 Using IBM JCC Driver', 
xaRecoveryAuthAlias=myCellManager01/xa1")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSource("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", "MyJDBCDS", 
[['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], 
['connectionTimeout', 1000], ['freePoolDistributionTableSize', 10], ['maxConnections', 12], ['minConnections', 5], 
['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], ['numberOfUnsharedPoolPartitions', 3], 
['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], ['value', 'value1b']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], ['stuckTimerTime', 10], 
['surgeThreshold', 10], ['testConnection', 'true']]], ['datasourceHelperClassname', 
'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]], ['properties', 
[[['name', 'name1'], ['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'integer'], ['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'integer'], ['value', 50000]]]]]], ['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 'SIB JMS Resource Adapter
(cells/IBM-F4A849C57A0Cell01/nodes/IBM-F4A849C57A0Node01/servers/server1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']])

createDataSourceUsingTemplate

此脚本会使用模板在配置中创建新数据源。此脚本会返回新数据源的配置标识。

要运行此脚本,请指定节点名、服务器名称、JDBC 提供程序、模板标识以及数据源名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 5. createDataSourceUsingTemplate 脚本. 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jdbcProvider 指定相关 JDBC 提供程序的名称。
templateID 指定要用来创建数据源的模板的配置标识。
dsName 指定要分配给新数据源的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 6. 可选属性. 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。  
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description 指定数据源的描述。
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'false']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'false']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。
['statementCacheSize', 5]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
表 7. 可选属性(续). 若干脚本有此属性。
属性 描述 示例
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Using IBM JCC Driver']

语法

providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSourceUsingTemplate(nodeName, 
 serverName, jdbcProvider, templateID, dsName, 
 attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createDataSourceUsingTemplate("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", "authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, description='My description', 
diagnoseConnectionUsage=true, jndiName=myJndiName, logMissingTransactionContext=false, manageCachedHandles=false, 
providerType='DB2 Using IBM JCC Driver', xaRecoveryAuthAlias=myCellManager01/xa1")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", [['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], ['connectionTimeout', 1000], 
['freePoolDistributionTableSize', 10], 
['maxConnections', 12], 
['minConnections', 5], ['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], 
['numberOfUnsharedPoolPartitions', 3], 
['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], ['value', 'value1b']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], ['stuckTimerTime', 10], 
['surgeThreshold', 10], ['testConnection', 'true']]], ['datasourceHelperClassname', 
'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]],
 ['properties', [[['name', 'name1'], 
['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], ['type', 'integer'], 
['value', 50000]]]]]], ['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 
'SIB JMS Resource Adapter(cells/IBM-F4A849C57A0Cell01/clusters/c1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']])

createDataSourceAtScope

此脚本会在配置中您所指定的作用域内创建新数据源。此脚本会返回新数据源的配置标识。此脚本过程会使用 createDatasource 管理命令来创建新数据源。createDataSource 脚本会使用 AdminConfig create 命令来创建新数据源。

要运行此脚本,请指定作用域、JDBC 提供程序、数据源名称以及数据库名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 8. createDataSourceAtScope 脚本. 必需参数和可选参数。
自变量 描述
scope 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域
JDBCName 指定相关 JDBC 提供程序的名称。
datasourceName 指定要分配给新数据源的名称。
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。
dataStoreHelperClassName 指定 DataStoreHelper 实现类的名称,该类可扩展所选的 JDBC 驱动程序实现类的能力以执行特定于数据的功能。
dbName(用于 Oracle 数据库的 URL 指定要分配给 JDBC 提供程序数据库的名称。

对于使用 Oracle 数据库的 JDBC 提供程序,此参数会指定数据源从中获取连接的数据库的 URL。示例为 jdbc:oracle:thin:@localhost:1521:sample(用于瘦驱动程序)和 jdbc:oracle:oci8:@sample(用于胖驱动程序)。

otherAttributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
resoureAttributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
failonerror 指定处理错误条件的管理实用程序。
表 9. 可选属性. 若干脚本有这些属性。
属性 描述
category 指定可用来对资源进行分类或分组的类别。
componentManagedAuthenticationAlias 指定运行时数据库认证所使用的别名。
containerManagedPersistence 指定在设置为 true 时启用容器管理的持久性。
description 指定数据源的描述。
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
表 10. 资源属性. 若干脚本有这些属性。
属性 描述
driverType 指定数据源类型。此数据源类型只适用于其数据库类型为 DB2 的 JDBC 提供程序。
portNumber 指定数据库服务器的端口号。此端口号只适用于其数据库类型为 DB2InformixSybaseSQLServer 的 JDBC 提供程序。
serverName 指定数据库服务器的主机名或 IP 地址。此服务器名称只适用于其数据库类型为 DB2InformixSybaseSQLServer 的 JDBC 提供程序。
ifxIFHOST 指定在数据库上获取锁定的连接等待时间。缺省情况下,在无法获取锁定时,Informix® 数据库会返回错误,而不是等待锁定的当前所有者释放该锁定。要修改行为,请将此属性设置为等待锁定的秒数。缺省值为 2 秒。任何负值都会转换为无限制的等待时间。此属性只适用于其数据库类型为 Informix 的 JDBC 提供程序。
informixLockModeWait 指定用于主管 Informix 实例的服务器的物理机器名称。您可以输入主机名或 IP 地址。如果主机数据库支持因特网协议版本 6 (IPv6),那么您也可以输入 IPv6 地址。此属性只适用于其数据库类型为 Informix 的 JDBC 提供程序。

语法

AdminJDBC.createDataSourceAtScope(scope,
 jdbcProvider, dsName, databaseName, attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createDataSourceAtScope("myScope", "myJDBCProvider", 
 "myDataSource", "myDatabase")

DB2® 数据库类型的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyTestJDBCProviderName", "newds2", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", "db1", 
" category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, containerManagedPersistence=true, 
description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", "serverName=localhost, 
driverType=4,portNumber=50000")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyTestJDBCProviderName", "newds2", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1", [['category', 'myCategory'], ['componentManagedAuthenticationAlias',
'CellManager01/AuthDataAliase'], ['containerManagedPersistence', 'true'], ['description', 'My description'], 
['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , [['serverName', 'localhost'], 
['driverType', 4], ['portNumber', 50000]])

Derby 数据库的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Derby JDBC Provider", "Derby DataSource", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1",  " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description=My description, xaRecoveryAuthAlias=CellManager01/xaAliase")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Derby JDBC Provider", "Derby DataSource", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1",  [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 
'CellManager01/xaAliase']])

Informix 数据库的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01", "Informix JDBC Driver Test", "My DataSource", 
"My JNDIName", "com.ibm.websphere.rsadapter.InformixDataStoreHelper", "MyDB", " category=myCategory, 
componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, containerManagedPersistence=true, 
description='My description', 
xaRecoveryAuthAlias=CellManager01/xaAliase", "serverName=ol_myserver, portNumber=50000, ifxIFXHOST=localhost, 
informixLockModeWait=2") 

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01", "Informix JDBC Driver Test", "My DataSource", 
"My JNDIName", "com.ibm.websphere.rsadapter.InformixDataStoreHelper", "MyDB", [['category', 'myCategory'], 
['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], ['containerManagedPersistence', 'true'], 
['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , [['serverName', 'ol_myserver'], 
['portNumber', 1526], ['ifxIFXHOST', 'localhost'], ['informixLockModeWait', 2]])

Oracle 数据库的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Oracle JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.OracleDataStoreHelper", 
"http://myURL.com",  "category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Oracle JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.OracleDataStoreHelper", 
"http://myURL.com",  
[['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias',
 'CellManager01/xaAliase']])

SQLServer 数据库的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Microsoft SQL Server JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SQLserverDataStoreHelper", 
"myDBName", " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", 
"serverName=localhost, portNumber=1433")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Microsoft SQL Server JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SQLserverDataStoreHelper", 
"myDBName", [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , 
[['serverName', 'localhost'], ['portNumber', 1433]])

Sybase 数据库的示例脚本:

以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Sybase JDBC 3 Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SybaseserverDataStoreHelper", 
"myDBName", " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", 
"serverName=localhost, portNumber=1433")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Sybase JDBC 3 Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SybaseserverDataStoreHelper", 
"myDBName", [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , 
[['serverName', 'localhost'], ['portNumber', 2638]])

createDataSourceUsingTemplateAtScope

此脚本会使用模板在配置中您所指定的作用域内创建新数据源。此脚本会返回新数据源的配置标识。

要运行此脚本,请指定作用域、JDBC 提供程序、模板标识以及数据源名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 11. createDataSourceUsingTemplateAtScope 脚本. 必需参数和可选参数。
自变量 描述
scope 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域
jdbcProvider 指定相关 JDBC 提供程序的名称。
templateID 指定要用来创建数据源的模板的配置标识。
dsName 指定要分配给新数据源的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 12. 可选属性. 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。  
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description 指定数据源的描述。
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'false']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'false']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。
['statementCacheSize', 5]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
表 13. 可选属性(续). 若干脚本有此属性。
属性 描述 示例
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Using IBM JCC Driver']

语法

providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSourceUsingTemplateAtScope(nodeName, 
 serverName, jdbcProvider, templateID, dsName, 
 attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createDataSourceUsingTemplateAtScope("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createDataSourceUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01/Server:server1", 
"My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", "authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, description='My description', 
diagnoseConnectionUsage=true, jndiName=myJndiName, logMissingTransactionContext=false, manageCachedHandles=false, 
providerType='DB2 Using IBM JCC Driver', xaRecoveryAuthAlias=myCellManager01/xa1")

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createDataSourceUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01/Server:server1", 
"My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", [['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], ['connectionTimeout', 1000], 
['freePoolDistributionTableSize', 10], 
['maxConnections', 12], ['minConnections', 5], ['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], 
['numberOfUnsharedPoolPartitions', 3], ['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], 
['value', 'value1b']]]], ['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], 
['stuckTimerTime', 10], ['surgeThreshold', 10], ['testConnection', 'true']]], 
['datasourceHelperClassname', 'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]], 
['properties', [[['name', 'name1'], 
['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], 
['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], ['type', 'integer'], ['value', 50000]]]]]],
['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 
'SIB JMS Resource Adapter(cells/IBM-F4A849C57A0Cell01/clusters/c1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']] )

createJDBCProvider

此脚本会在环境中创建新 JDBC 提供程序。此脚本会返回新 JDBC 提供程序的配置标识。

要运行此脚本,请指定节点名、服务器名称、JDBC 提供程序以及实现类参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 14. createJDBCProvider 脚本. 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jdbcProvider 指定要分配给新 JDBC 提供程序的名称。
implementationClass 指定要使用的实现类的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 15. 可选属性. 若干脚本有这些属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description 指定资源适配器的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
['isolatedClassLoader', 'false']
nativepath 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
表 16. 可选属性(续). 若干脚本有这些属性。
属性 描述 示例
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Universal JDBC Driver Provider']
xa 可能的值是 truefalse。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。
true

false

语法

实现类可选属性

语法

使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
implementationClassName 属性示例用法:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
结果:
com.ibm.db2.jcc.DB2XADataSource
一些可能的实现类名:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createJDBCProvider(nodeName, serverName, 
 jdbcProvider, implementationClass, attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider", 
 "myImplementationClass")
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createJDBCProvider("IBM-F4A849C57A0Node01", "server1", "My JDBC Name", 
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
" classpath=${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createJDBCProvider("IBM-F4A849C57A0Node01", "server1", "My JDBC Name", 
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'], ['value', 50000]]]]]]])

createJDBCProviderUsingTemplate

此脚本会使用模板在环境中创建新 JDBC 提供程序。此脚本会返回新 JDBC 提供程序的配置标识。

要运行此脚本,请指定节点名、服务器名称、模板标识、JDBC 提供程序名称以及实现类参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 17. createJDBCProviderUsingTemplate 脚本. 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
templateID 指定要用来创建 JDBC 提供程序的模板的配置标识。
jdbcProvider 指定要分配给新 JDBC 提供程序的名称。
implementationClass 指定要使用的实现类的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 18. 可选属性. 若干脚本有这些属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description 指定资源适配器的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
['isolatedClassLoader', 'false']
nativepath 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
表 19. 可选属性(续). 若干脚本有这些属性。
属性 描述 示例
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Universal JDBC Driver Provider']
xa 可能的值是 truefalse。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。
true

false

语法

实现类可选属性

语法

使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
implementationClassName 属性示例用法:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
结果:
com.ibm.db2.jcc.DB2XADataSource
一些可能的实现类名:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createJDBCProviderUsingTemplate(nodeName, 
 serverName, templateID, jdbcProvider, 
 implementationClass, attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createJDBCProviderUsingTemplate("myNode", "myServer", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createJDBCProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name", "com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
"classpath= ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createJDBCProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)",
 My JDBC Name", 
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'], ['value', 50000]]]]]]])

createJDBCProviderAtScope

此脚本会在环境中您所指定的作用域内创建新 JDBC 提供程序。此脚本会返回新 JDBC 提供程序的配置标识。此脚本过程会使用 createJDBCProvider 管理命令来创建新 JDBC 提供程序。createJDBCProvider 脚本过程通过使用 AdminConfig create 命令来创建新 JDBC 提供程序。

要运行此脚本,请指定作用域、JDBC 提供程序、数据库类型、提供程序类型以及实现类型参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 20. createJDBCProviderAtScope 脚本. 必需参数和可选参数。
自变量 描述
scope 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域
databaseType 指定此 JDBC 提供程序所使用的数据库类型。有效值包括 DB2DerbyInformixOracleSybaseSQL Server 以及用户定义的值。
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
implType 指定此 JDBC 提供程序所使用的实现类型。有效值为连接池数据源XA 数据源
jdbcProvider 指定要分配给新 JDBC 提供程序的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 21. 可选属性. 若干脚本有这些属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description 指定资源适配器的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
['isolatedClassLoader', 'false']
nativepath 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
表 22. 可选属性(续). 若干脚本有此属性。
属性 描述
implementationClassName 指定要用于给定 JDBC 提供程序模板的实现类
providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
implementationClassName 属性

语法

使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
implementationClassName 属性示例用法:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
结果:
com.ibm.db2.jcc.DB2XADataSource
一些可能的实现类名:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource

createJDBCProviderAtScope 脚本

语法

AdminJDBC.createJDBCProviderAtScope(scope,
 jdbcProvider, databaseType, providerType, implementationType,
 attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createJDBCProviderAtScope("myScope", "myJDBCProvider", "myDatabaseType","myProviderType", 
"myImplementationClass")
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createJDBCProviderAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01", "DB2", 
"DB2 Universal JDBC Driver Provider", "Connection pool data source", "My JDBCProvider Name", 
"description='My description', implementationClassName=com.ibm.db2.jcc.DB2ConnectionPoolDataSource, 
classpath=${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
nativePath=${DB2_JCC_DRIVER_NATIVEPATH}, isolatedClassLoader=false”)

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createJDBCProviderAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01", "DB2", 
"DB2 Universal JDBC Driver Provider", "Connection pool data source", "My JDBCProvider Name", [['description', 'My description'],
[ 'implementationClassName ', 'com.ibm.db2.jcc.DB2ConnectionPoolDataSource'],
[ 'classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'],
[ 'nativePath', '${DB2_JCC_DRIVER_NATIVEPATH}'], ['isolatedClassLoader', 'false'] ])

createJDBCProviderUsingTemplateAtScope

此脚本会使用模板在环境中您所指定的作用域内创建新 JDBC 提供程序。此脚本会返回新 JDBC 提供程序的配置标识。

要运行此脚本,请指定作用域、模板标识、JDBC 提供程序名称以及实现类参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 23. createJDBCProviderUsingTemplateAtScope 脚本. 必需参数和可选参数。
自变量 描述
scope 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域
templateID 指定要用来创建 JDBC 提供程序的模板的配置标识。
jdbcProvider 指定要分配给新 JDBC 提供程序的名称。
implementationClassName 指定要使用的实现类的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 24. 可选属性. 若干脚本有这些属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description 指定资源适配器的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
['isolatedClassLoader', 'false']
nativepath 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
表 25. 可选属性(续). 若干脚本有这些属性。
属性 描述 示例
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型
['providerType', 'DB2 Universal JDBC Driver Provider']
xa 可能的值是 truefalse。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。
true

false
实现类可选属性

语法

使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
implementationClassName 属性示例用法:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
结果:
com.ibm.db2.jcc.DB2XADataSource
一些可能的实现类名:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
providerType 可选属性

语法

使用以下命令语法来查找 JDBC 提供程序类型名称。只有包含 templates/system|jdbc-resource-provider-templates.xml 子串的 JDBC 提供程序模板标识,才具有有效的 JDBC 提供程序类型名称。JDBC 提供程序类型名称及其子串构成 JDBC 提供程序模板标识。
AdminConfig.listTemplates('JDBCProvider')
示例部分结果,显示 Derby JDBC 提供程序 (XA) 的 JDBC 提供程序类型名称的 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
一些 JDBC 提供程序模板标识:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)

createJDBCProviderUsingTemplateAtScope 脚本

语法

AdminJDBC.createJDBCProviderUsingTemplateAtScope(scope, 
  templateID, jdbcProvider, 
 implementationClass, attributes)

用法示例

以下示例脚本仅包含必需属性:

AdminJDBC.createJDBCProviderUsingTemplateAtScope("myScope", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
以下示例脚本包含字符串格式的可选属性:
AdminJDBC.createJDBCProviderUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/ServerCluster:cluster1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name001", " com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
"classpath= ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

以下示例脚本包含列表格式的可选属性:

AdminJDBC.createJDBCProviderUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/ServerCluster:cluster1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name001", " com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'], 
['value', 50000]]]]]]])

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7adminjdbc
文件名:rxml_7adminjdbc.html