J2C 配置脚本

此脚本库提供许多脚本过程来管理 Java™ 2 连接器 (J2C) 配置。使用本主题中的脚本来创建激活规范、管理对象和连接工厂,以及安装资源适配器。您可以单独运行每个脚本,也可以组合许多过程以创建环境的定制自动化脚本。

每个 J2C 管理脚本过程都位于 app_server_root/scriptLibraries/resources/J2C 目录中。

createJ2CActivationSpec

此脚本会在配置中创建 J2C 激活规范。此脚本会返回新 J2C 激活规范的配置标识。

要运行该脚本,请指定资源适配器、激活规范名称、消息侦听器类型以及 Java 命名和目录接口 (JNDI) 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 1. createJ2CActivationSpec 脚本. 运行该脚本以创建 J2C 激活规范。
参数 描述
resourceAdapterID 指定相关资源适配器的配置标识。
activationSpecName 指定要分配给新激活规范的名称。
messageListenerType 指定消息侦听器类型。
jndiName 指定 Java 命名和目录接口 (JNDI) 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 2. 可选属性. 适用于该脚本的其他属性。
属性 描述 示例
authenticationAlias 指定所创建 J2C 激活规范的认证别名。
["authenticationAlias", "myAlias"]
description 指定所创建 J2C 激活规范的描述。
["description", "My description"]
destinationJndiName 指定所创建的 J2C 激活规范的目标 JNDI 名称。
["destinationJndiName", "myDestinationJndi"]

语法

AdminJ2C.createJ2CActivationSpec(resourceAdapterID, 
 activationSpecName, messageListenerType, jndiName,
 attributes)

用法示例

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

AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578))", "J2CASTest", "javax.jms.MessageListener2", "jndiAS")
以下示例脚本包含字符串格式的可选属性:
AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)",
"J2CASTest","javax.jms.MessageListener", "jndi/as1",
"description=this is my J2C ActivationSpecification, 
destinationJndiName=jndi/J2CAS, authenticationAlias=J2CASTest")

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

AdminJ2C.createJ2CActivationSpec(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CAC1", "javax.jms.MessageListener", "jndi/as", [['description','new j2cActivationSpec'],
['destinationJndiName','ds/jndi'], ['authenticationAlias','test']])

createJ2CAdminObject

此脚本会在配置中创建 J2C 管理对象。此脚本会返回新 J2C 管理对象的配置标识。

要运行该脚本,请指定资源适配器、激活规范名称、Java 命名和目录接口 (JNDI) 名称以及管理对象接口名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 3. createJ2CAdminObject 脚本. 运行该脚本以创建 J2C 管理对象。
参数 描述
resourceAdapterID 指定相关资源适配器的配置标识。
activationSpecName 指定要分配给新激活规范的名称。
adminObjectInterface 指定管理对象接口的名称。
jndiName 指定 Java 命名和目录接口 (JNDI) 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 4. 可选属性. 适用于该脚本的其他属性。
属性 描述 示例
description 指定所创建 J2C 管理对象的描述。
["description", "My description"]

语法

AdminJ2C.createJ2CAdminObject(resourceAdapterID, 
 activationSpecName, adminObjectInterface, jndiName,
 attributes)

用法示例

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

AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578)",
 "J2CAOTest", "fvt.adapter.message.FVTMessageProvider2", "jndiAO")
以下示例脚本包含字符串格式的可选属性:
AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)",
"J2CAOTest", "fvt.adapter.message.FVTMessageProvider", "jndi/ao1", 
"description=this is my J2C AdminObject")

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

AdminJ2C.createJ2CAdminObject(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CAO1", "fvt.adapter.message.FVTMessageProvider", "jndi/ao",
[['description','new j2cAdminObject']])

createJ2CConnectionFactory

此脚本会在配置中创建新 J2C 连接工厂。此脚本会返回新 J2C 连接工厂的配置标识。

要运行该脚本,请指定资源适配器、连接工厂名称、连接工厂接口以及 Java 命名和目录接口 (JNDI) 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 5. createJ2CConnectionFactory 脚本. 运行该脚本以创建 J2C 连接工厂。
参数 描述
resourceAdapterID 指定相关资源适配器的配置标识。
connFactoryName 指定要分配给新连接工厂的名称。
connFactoryInterface 指定连接工厂接口。
jndiName 指定 Java 命名和目录接口 (JNDI) 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 6. 可选属性. 适用于该脚本的其他属性。
属性 描述 示例
authDataAlias 指定所创建连接工厂的组件管理认证数据别名。
["authDataAlias", "myAuthDataAlias"]
description 指定所创建 J2C 连接工厂的描述。
["description", "My description"]

语法

AdminJ2C.createJ2CConnectionFactory(resourceAdapterID, 
 connFactoryName, connFactoryInterface, jndiName,
 attributes)

用法示例

AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_11840917675
578)", "J2CCFTest", "javax.sql.DataSource2", "jndiCF")
以下示例脚本包含字符串格式的可选属性:
AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CCFTest", "javax.sql.DataSource", "jndi/j2ccftest",
"description=this is my J2CConnectionFactory, authDataAlias=J2CTest")

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

AdminJ2C.createJ2CConnectionFactory(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CCFTest", "javax.sql.DataSource2", "jndi/cf", 
[['description', 'new j2ccf'], ['authDataAlias', 'test']]) 

installJ2CResourceAdapter

此脚本会在配置中安装 J2C 资源适配器。此脚本会返回新 J2C 资源适配器的配置标识。

要运行该脚本,请指定节点名、资源适配器归档 (RAR) 文件以及资源适配器名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 7. installJ2CResourceAdapter 脚本. 运行该脚本以安装 J2C 资源适配器。
参数 描述
nodeName 指定相关节点的名称。
rarFile 指定要安装的 RAR 文件的标准文件路径。
resourceAdapterName 指定要分配给新资源适配器的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 8. 可选属性. 适用于该脚本的其他属性。
属性 描述
rar.desc 指定 J2C 资源适配器的描述。
rar.archivePath 指定在其中解压缩文件的路径的名称。如果未指定此路径,那么会将归档解压缩到 $CONNECTOR_INSTALL_ROOT 目录。
rar.classpath 指定其他类路径。
rar.nativePath 指定本机路径。
rar.threadPoolAlias 指定线程池的别名。
rar.propertiesSet 指定 J2C 资源适配器的属性集。
rar.DeleteSourceRar 指定是否要删除源 RAR 文件。
rar.isolatedClassLoader 指定隔离类装入器的布尔值。
rar.enableHASupport 指定启用高可用性的布尔值。
rar.HACapability 指定高可用性功能的种类。

语法

AdminJ2C.installJ2CResourceAdapter(nodeName, rarFile, 
 resourceAdapterName, attributes)

用法示例

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

[Windows]
AdminJ2C.installJ2CResourceAdapter("myNode", 
 "C:\temp\jca15cmd.rar", "J2CTest")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")

以下示例脚本包含字符串格式的可选属性:

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "c:\ears\jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=c:\temp\test.rar, rar.classpath=c:\temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "/ears/jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=/temp/test.rar, rar.classpath=/temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")

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

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "c:\ears\jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', 'c:\temp\test.rar'], ['rar.classpath', 'c:\temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "/ears/jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', '/temp/test.rar'], ['rar.classpath', '/temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])

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



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