JDBC 配置脚本

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

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

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

作用域参数的格式

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

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

可以使用逗号 (，) 或冒号 (:) 对类型进行定界。 可以将较早的案例用于类型 (cell = ， node = ， server= 或 cluster =。)

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

表 1. 特定作用域的包含路径，配置标识和类型的示例。 作用域可以是单元、节点、服务器或集群。
作用域 包含路径 配置标识 类型
Cell /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
服务器 
/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。 createData源脚本。 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jdbcProvider 指定相关 JDBC 提供程序的名称。
dsName 指定要分配给新数据源的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 3. 可选属性。 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定运行时数据库认证所使用的别名。 
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。 有效值为 BASIC_PASSWORD（用于基本认证）和 KERBEROS（用于 Kerberos 认证）。  
类别 指定可用来对资源进行分类或分组的类别。 
['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"]]]
datasourceHelper类名 指定 DataStoreHelper 实现类的名称，此实现类可扩展 JDBC 驱动程序的实现类的功能。 扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
描述 指定数据源的描述。 
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。 
['logMissingTransactionContext', 'false']
manageCached句柄 指定是否将此数据源用于企业 Bean 的容器管理持久性。 缺省值为 true。 
['manageCachedHandles', 'false']
Mapping 指定配置登录至所指定认证别名的映射。

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

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

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

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

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

 
["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]] ]]]]
relationalResource适配器 指定数据源所使用的关系资源适配器。 可以使用 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 script。 必需参数和可选参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jdbcProvider 指定相关 JDBC 提供程序的名称。
templateID 指定要用来创建数据源的模板的配置标识。
dsName 指定要分配给新数据源的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 6. 可选属性。 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定运行时数据库认证所使用的别名。 
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。 有效值为 BASIC_PASSWORD（用于基本认证）和 KERBEROS（用于 Kerberos 认证）。  
类别 指定可用来对资源进行分类或分组的类别。 
['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"]]]
datasourceHelper类名 指定 DataStoreHelper 实现类的名称，此实现类可扩展 JDBC 驱动程序的实现类的功能。 扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
描述 指定数据源的描述。 
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。 
['logMissingTransactionContext', 'false']
manageCached句柄 指定是否将此数据源用于企业 Bean 的容器管理持久性。 缺省值为 true。 
['manageCachedHandles', 'false']
Mapping 指定配置登录至所指定认证别名的映射。

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

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

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

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

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

 
["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]] ]]]]
relationalResource适配器 指定数据源所使用的关系资源适配器。 可以使用 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。 createDataSourceAt作用域脚本。 必需参数和可选参数。
自变量 描述
scope 指定 JDBC 提供程序的单元，节点，服务器或集群的 作用域 。
JDBCName 指定相关 JDBC 提供程序的名称。
datasourceName 指定要分配给新数据源的名称。
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。
dataStoreHelperClass名称 指定 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"
故障错误 指定处理错误条件的管理实用程序。
表 9。 可选属性。 若干脚本有这些属性。
属性 描述
类别 指定可用来对资源进行分类或分组的类别。
componentManagedAuthenticationAlias 指定在运行时用于数据库认证的别名。
containerManaged持久性 指定在设置为 true 时启用容器管理的持久性。
描述 指定数据源的描述。
xaRecoveryAuthAlias 指定 XA 恢复处理期间使用的数据库认证别名。 如果指定此属性，那么缺省值是用于进行应用程序认证的别名。
表 10. 资源属性。 若干脚本有这些属性。
属性 描述
driverType 指定数据源类型。 此数据源类型只适用于其数据库类型为 DB2 的 JDBC 提供程序。
portNumber 指定数据库服务器的端口号。 此端口号只适用于其数据库类型为 DB2、Informix、Sybase 或 SQLServer 的 JDBC 提供程序。
serverName 指定数据库服务器的主机名或 IP 地址。 此服务器名称只适用于其数据库类型为 DB2、Informix、Sybase 或 SQLServer 的 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. createDataSourceUsingTemplateAt作用域脚本。 必需参数和可选参数。
自变量 描述
scope 指定 JDBC 提供程序的单元，节点，服务器或集群的 作用域 。
jdbcProvider 指定相关 JDBC 提供程序的名称。
templateID 指定要用来创建数据源的模板的配置标识。
dsName 指定要分配给新数据源的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 12. 可选属性。 若干脚本有这些属性。
属性 描述 示例
authDataAlias 指定在运行时用于数据库认证的别名。 
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。 有效值为 BASIC_PASSWORD（用于基本认证）和 KERBEROS（用于 Kerberos 认证）。  
类别 指定可用来对资源进行分类或分组的类别。 
['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"]]]
datasourceHelper类名 指定 DataStoreHelper 实现类的名称，此实现类可扩展 JDBC 驱动程序的实现类的功能。 扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
描述 指定数据源的描述。 
['description', 'My description']
jndiName 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 
['jndiName', 'myJndiName']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。 
['logMissingTransactionContext', 'false']
manageCached句柄 指定是否将此数据源用于企业 Bean 的容器管理持久性。 缺省值为 true。 
['manageCachedHandles', 'false']
Mapping 指定配置登录至所指定认证别名的映射。

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

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

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

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

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

 
["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]] ]]]]
relationalResource适配器 指定数据源所使用的关系资源适配器。 可以使用 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 指定要使用的 实现类 的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["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', 'My description']
isolatedClass装入器 如果设置为 true，那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定本机库路径时，提供程序不能是 isolatedClass装入器。
 
['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 可能的值是 true 和 false。 如果设置为 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 指定要使用的 实现类 的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["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', 'My description']
isolatedClass装入器 如果设置为 true，那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定本机库路径时，提供程序不能是 isolatedClass装入器。
 
['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 可能的值是 true 和 false。 如果设置为 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 提供程序所使用的数据库类型。 有效值包括 DB2， Derby， Informix， Oracle， Sybase， SQL Server和用户定义的值。
providerType 指定此 JDBC 提供程序使用的 JDBC 提供程序类型 。
implType 指定此 JDBC 提供程序所使用的实现类型。 有效值为Connection pool datasource和XA data source。
jdbcProvider 指定要分配给新 JDBC 提供程序的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["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', 'My description']
isolatedClass装入器 如果设置为 true，那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定本机库路径时，提供程序不能是 isolatedClass装入器。
 
['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 指定要使用的 实现类 的名称。
属性
选择性地以特定格式指定其他属性：
列表格式
[["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', 'My description']
isolatedClass装入器 如果设置为 true，那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定本机库路径时，提供程序不能是 isolatedClass装入器。
 
['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 可能的值是 true 和 false。 如果设置为 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]]]]]]])