J2C 配置脚本
此脚本库提供许多脚本过程来管理 Java™ 2 连接器 (J2C) 配置。使用本主题中的脚本来创建激活规范、管理对象和连接工厂,以及安装资源适配器。您可以单独运行每个脚本,也可以组合许多过程以创建环境的定制自动化脚本。
每个 J2C 管理脚本过程都位于 app_server_root/scriptLibraries/resources/J2C 目录中。
createJ2CActivationSpec
此脚本会在配置中创建 J2C 激活规范。此脚本会返回新 J2C 激活规范的配置标识。
要运行该脚本,请指定资源适配器、激活规范名称、消息侦听器类型以及 Java 命名和目录接口 (JNDI) 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
参数 | 描述 |
---|---|
resourceAdapterID | 指定相关资源适配器的配置标识。 |
activationSpecName | 指定要分配给新激活规范的名称。 |
messageListenerType | 指定消息侦听器类型。 |
jndiName | 指定 Java 命名和目录接口 (JNDI) 名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
authenticationAlias | 指定所创建 J2C 激活规范的认证别名。 |
|
description | 指定所创建 J2C 激活规范的描述。 |
|
destinationJndiName | 指定所创建的 J2C 激活规范的目标 JNDI 名称。 |
|
语法
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) 名称以及管理对象接口名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
参数 | 描述 |
---|---|
resourceAdapterID | 指定相关资源适配器的配置标识。 |
activationSpecName | 指定要分配给新激活规范的名称。 |
adminObjectInterface | 指定管理对象接口的名称。 |
jndiName | 指定 Java 命名和目录接口 (JNDI) 名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
description | 指定所创建 J2C 管理对象的描述。 |
|
语法
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) 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
参数 | 描述 |
---|---|
resourceAdapterID | 指定相关资源适配器的配置标识。 |
connFactoryName | 指定要分配给新连接工厂的名称。 |
connFactoryInterface | 指定连接工厂接口。 |
jndiName | 指定 Java 命名和目录接口 (JNDI) 名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 | 示例 |
---|---|---|
authDataAlias | 指定所创建连接工厂的组件管理认证数据别名。 |
|
description | 指定所创建 J2C 连接工厂的描述。 |
|
语法
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) 文件以及资源适配器名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
参数 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
rarFile | 指定要安装的 RAR 文件的标准文件路径。 |
resourceAdapterName | 指定要分配给新资源适配器的名称。 |
attributes | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
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]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("myNode",
"C:\temp\jca15cmd.rar", "J2CTest")
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")
以下示例脚本包含字符串格式的可选属性:
![[Windows]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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']])