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

作用域参数的格式
作用域格式应用于脚本库中具有该作用域参数的脚本。
在节点、服务器和集群作用域上,单元是可选的。在服务器作用域上,节点是必需的。
可以使用逗号 (,) 或分号 (:) 来定界类型。可以使用小写表示类型(cell=、node=、server= 或 cluster=)。
为了方便发布,下表中的示例分布在多行上。
作用域 | 包含路径 | 配置标识 | 类型 |
---|---|---|---|
单元 | /Cell:myCell/ |
|
Cell=myCell 或 cell=myCell |
节点 | /Cell:myCell/Node:myNode/ 或 /Node:myNode/ |
|
或
或
|
Server |
或
|
|
或
或
|
集群 |
或
|
|
或
或
|
createDataSource
此脚本会在配置中创建新数据源。此脚本会返回新数据源的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
jdbcProvider | 指定相关 JDBC 提供程序的名称。 |
dsName | 指定要分配给新数据源的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
authDataAlias | 指定运行时数据库认证所使用的别名。 |
|
authMechanismPreference | 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。 | |
category | 指定可用来对资源进行分类或分组的类别。 |
|
connectionPool | 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
datasourceHelperClassname | 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 |
|
description | 指定数据源的描述。 |
|
jndiName | 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 |
|
logMissingTransactionContext | 指定是否启用对缺少的事务上下文进行记录。 |
|
manageCachedHandles | 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True。 |
|
mapping | 指定配置登录至所指定认证别名的映射。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
preTestConfig | 指定预测试连接配置设置。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
properties | 指定类型化属性类型或描述性属性类型。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
relationalResourceAdapter | 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。 |
|
statementCacheSize | 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。 |
|
xaRecoveryAuthAlias | 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。 |
|
属性 | 描述 | 示例 |
---|---|---|
providerType | 指定此 JDBC 提供程序所使用的 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)
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
此脚本会使用模板在配置中创建新数据源。此脚本会返回新数据源的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
jdbcProvider | 指定相关 JDBC 提供程序的名称。 |
templateID | 指定要用来创建数据源的模板的配置标识。 |
dsName | 指定要分配给新数据源的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
authDataAlias | 指定运行时数据库认证所使用的别名。 |
|
authMechanismPreference | 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。 | |
category | 指定可用来对资源进行分类或分组的类别。 |
|
connectionPool | 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
datasourceHelperClassname | 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 |
|
description | 指定数据源的描述。 |
|
jndiName | 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 |
|
logMissingTransactionContext | 指定是否启用对缺少的事务上下文进行记录。 |
|
manageCachedHandles | 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True。 |
|
mapping | 指定配置登录至所指定认证别名的映射。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
preTestConfig | 指定预测试连接配置设置。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
properties | 指定类型化属性类型或描述性属性类型。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
relationalResourceAdapter | 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。 |
|
statementCacheSize | 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。 |
|
xaRecoveryAuthAlias | 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。 |
|
属性 | 描述 | 示例 |
---|---|---|
providerType | 指定此 JDBC 提供程序所使用的 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)
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 命令来创建新数据源。
自变量 | 描述 |
---|---|
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 | 选择性地以特定格式指定其他属性:
|
resoureAttributes | 选择性地以特定格式指定其他属性:
|
failonerror | 指定处理错误条件的管理实用程序。 |
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
componentManagedAuthenticationAlias | 指定运行时数据库认证所使用的别名。 |
containerManagedPersistence | 指定在设置为 true 时启用容器管理的持久性。 |
description | 指定数据源的描述。 |
xaRecoveryAuthAlias | 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。 |
属性 | 描述 |
---|---|
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
此脚本会使用模板在配置中您所指定的作用域内创建新数据源。此脚本会返回新数据源的配置标识。
自变量 | 描述 |
---|---|
scope | 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域。 |
jdbcProvider | 指定相关 JDBC 提供程序的名称。 |
templateID | 指定要用来创建数据源的模板的配置标识。 |
dsName | 指定要分配给新数据源的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
authDataAlias | 指定运行时数据库认证所使用的别名。 |
|
authMechanismPreference | 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。 | |
category | 指定可用来对资源进行分类或分组的类别。 |
|
connectionPool | 指定父 JDBC 连接工厂实例的 JDBC 连接池属性。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
datasourceHelperClassname | 指定 DataStoreHelper 实现类的名称,此实现类可扩展 JDBC 驱动程序的实现类的功能。扩展功能可让 JDBC 驱动程序执行特定于数据的功能。 |
|
description | 指定数据源的描述。 |
|
jndiName | 指定此数据源的 Java 命名和目录接口 (JNDI) 名称。 |
|
logMissingTransactionContext | 指定是否启用对缺少的事务上下文进行记录。 |
|
manageCachedHandles | 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True。 |
|
mapping | 指定配置登录至所指定认证别名的映射。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
preTestConfig | 指定预测试连接配置设置。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
properties | 指定类型化属性类型或描述性属性类型。 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
relationalResourceAdapter | 指定数据源所使用的关系资源适配器。可以使用 AdminConfig.list('J2CResourceAdapter') 命令来识别 J2CResourceAdapterID 的可用 Java 2 连接器 (J2C) 资源适配器标识。 |
|
statementCacheSize | 指定该产品可以为每个连接高速缓存的语句数。该产品通过对活动连接中未使用的预编译语句和可调用语句进行高速缓存来优化对语句的处理。这两个语句类型改善应用程序与数据存储之间事务的性能。 将语句高速缓存会使其更便捷地可用。 |
|
xaRecoveryAuthAlias | 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。 |
|
属性 | 描述 | 示例 |
---|---|---|
providerType | 指定此 JDBC 提供程序所使用的 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)
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 提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
jdbcProvider | 指定要分配给新 JDBC 提供程序的名称。 |
implementationClass | 指定要使用的实现类的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
|
description | 指定资源适配器的描述。 |
|
isolatedClassLoader | 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。 注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
|
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。 |
|
属性 | 描述 | 示例 |
---|---|---|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
providerType | 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型。 |
|
xa | 可能的值是 true 和 false。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。 |
|
语法
- 实现类可选属性
语法
使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
implementationClassName 属性示例用法:AdminConfig.showAttribute(JDBCProvID,'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 提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
templateID | 指定要用来创建 JDBC 提供程序的模板的配置标识。 |
jdbcProvider | 指定要分配给新 JDBC 提供程序的名称。 |
implementationClass | 指定要使用的实现类的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
|
description | 指定资源适配器的描述。 |
|
isolatedClassLoader | 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。 注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
|
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。 |
|
属性 | 描述 | 示例 |
---|---|---|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
providerType | 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型。 |
|
xa | 可能的值是 true 和 false。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。 |
|
语法
- 实现类可选属性
语法
使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
implementationClassName 属性示例用法:AdminConfig.showAttribute(JDBCProvID,'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 提供程序。
自变量 | 描述 |
---|---|
scope | 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域。 |
databaseType | 指定此 JDBC 提供程序所使用的数据库类型。有效值包括 DB2、Derby、Informix、Oracle、Sybase、SQL Server 以及用户定义的值。 |
providerType | 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型。 |
implType | 指定此 JDBC 提供程序所使用的实现类型。有效值为连接池数据源和 XA 数据源。 |
jdbcProvider | 指定要分配给新 JDBC 提供程序的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
|
description | 指定资源适配器的描述。 |
|
isolatedClassLoader | 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。 注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
|
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。 |
|
属性 | 描述 |
---|---|
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 属性:
implementationClassName 属性示例用法:AdminConfig.showAttribute(JDBCProvID,'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 提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为 JDBC 提供程序指定单元、节点、服务器或集群的作用域。 |
templateID | 指定要用来创建 JDBC 提供程序的模板的配置标识。 |
jdbcProvider | 指定要分配给新 JDBC 提供程序的名称。 |
implementationClassName | 指定要使用的实现类的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
|
description | 指定资源适配器的描述。 |
|
isolatedClassLoader | 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。 注意: 指定了本机库路径时,提供程序不能为 isolatedClassLoader。
|
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。使用分号 (;) 来分隔本机路径条目。 |
|
属性 | 描述 | 示例 |
---|---|---|
propertySet | 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]]
]]]] 在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。 |
|
providerType | 指定此 JDBC 提供程序所使用的 JDBC 提供程序类型。 |
|
xa | 可能的值是 true 和 false。如果设置为 true,那么提供程序的数据源生成连接,应用程序在两阶段落实的全局事务中使用这些连接。 如果设置为 false,数据源生成连接,应用程序将在单阶段落实的本地事务中使用这些连接。 |
|
- 实现类可选属性
语法
使用以下命令语法,通过指定 JDBCProvID 的 JDBC 提供程序模板标识来查找 implmentationClassName 属性:
implementationClassName 属性示例用法:AdminConfig.showAttribute(JDBCProvID,'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]]]]]]])