使用 wsadmin 脚本编制工具来配置带有资源适配器归档 (RAR) 文件的 Java™ 2 连接器资源适配器。RAR 文件为访问特定企业信息系统 (EIS)(例如,客户信息控制系统 (CICS®))提供了支持资源适配器的类和其他代码。在安装适当的 RAR 文件之后,仅为 EIS 配置资源适配器。
开始之前
RAR 文件通常被称为 Java 连接器体系结构 (JCA) 连接器,它必须符合 JCA 1.5 和 1.6 规范。为了使资源适配器支持 JCA V1.6,已在 RAR 模块中添加了对 Java 注释的支持。有关注释支持和元数据的更多信息,请参阅“对于 RAR 模块中的注释的 JCA 1.6 支持”主题。
请通过使用受支持的组装工具(如“组装工具”一文中所述)来满足这些需求,以将
Java 归档 (JAR) 文件集合、其他可运行组件以及实用程序类等等组装成可部署的 RAR 文件。然后,可以开始将该 RAR 文件安装到
Application Server 中。
可通过两种方法来完成本任务。本主题使用 AdminConfig 对象来安装资源适配器。或者,可以使用 AdminJ2C 脚本库中的 installJ2CResourceAdapter 脚本在配置中安装 J2C 资源适配器,如下例所示:
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")
脚本库提供了一组过程,可自动执行最常见的管理功能。
可以逐个运行每个脚本过程,也可以将几个过程组合在一起来快速开发新脚本。
过程
- 启动 wsadmin 脚本。 有关更多信息,请参阅“启动 wsadmin 脚本编制客户机”一文。
- 标识将要在其中安装资源适配器的节点的配置标识,如下例所示:
示例输出:
mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
- 标识可选属性。
J2CResourceAdapter 对象不需要特定参数。使用以下命令来显示 J2CResourceAdapter 对象的可选属性:
下列内容显示了用于显示每个可选属性及其数据类型的命令输出,并表示了缺省属性:
Attribute Type Default
name Stringdescription String
classpath String
nativepath String
providerType String
isolatedClassLoader boolean false
archivePath String
threadPoolAlias String Default
singleton boolean false
hACapability ENUM RA_NO_HA
isEnableHASupport boolean false
propertySet J2EEResourcePropertySet
jaasLoginConfiguration JAASConfigurationEntry
deploymentDescriptor Connector
connectionDefTemplateProps ConnectionDefTemplateProps
activationSpecTemplateProps ActivationSpecTemplateProps
j2cAdminObjects J2CAdminObject
adminObjectTemplateProps AdminObjectTemplateProps
j2cActivationSpec J2CActivationSpecproperties Property
- 设置相关属性。
确定要为 J2C 资源适配器进行配置的属性。在以下示例中,这些命令将 RAR 文件路径设置为 rarFile 变量,并将名称选项和描述配置选项设置为 option 变量:
- 创建资源适配器。
使用 AdminConfig 对象的 installResourceAdapter 命令通过先前设置的配置选项来安装资源适配器,如下例所示:
使用 Jacl:
$AdminConfig installResourceAdapter $rarFile mynode $option
使用 Jython:
AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
示例输出:
RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
- 保存配置更改。请参阅“使用 wsadmin 工具保存配置更改”主题,以了解更多信息。
- 仅在 Network Deployment 环境中使节点同步。请参阅“使用 wsadmin 工具同步节点”主题,以了解更多信息。