Use the wsadmin scripting tool to configure Java™ 2 Connector resource adapters with Resource
Adapter Archive (RAR) files. A RAR file provides the classes and other
code to support a resource adapter for access to a specific enterprise
information system (EIS), such as the Customer Information Control
System (CICS®). Configure resource
adapters for an EIS only after you install the appropriate RAR file.
Before you begin
A RAR file, which is often called a Java Connector Architecture (JCA) connector,
must comply with the JCA 1.5 and 1.6 Specification. For resource adapters
to support JCA Version 1.6, there is added support for Java annotations in RAR modules. For more information
on annotation support and metadata, see the topic, JCA 1.6 support
for annotations in RAR modules.
Meet these requirements by
using a supported assembly tool (as described in the Assembly tools
article) to assemble a collection of Java archive
(JAR) files, other runnable components, utility classes, and so on,
into a deployable RAR file. Then you are ready to install your RAR
file in Application Server.
There are two ways to complete this
task. This topic uses the AdminConfig object to install resource adapters.
Alternatively, you can use the installJ2CResourceAdapter script in
the AdminJ2C script library to install a J2C resource adapter in your
configuration, as the following example demonstrates:
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")
The scripting library provides a set of
procedures to automate the most common administration functions. You
can run each script procedure individually, or combine several procedures
to quickly develop new scripts.
Procedure
- Launch the wsadmin script.
See the topic Starting
the wsadmin scripting client article for more information.
- Identify the configuration ID of the node to which the
resource adapter is installed, as the following examples demonstrate:
Example output:
mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
- Identify the optional attributes.
The J2CResourceAdapter
object does not require specific arguments. Use the following command
to display the optional attributes for the J2CResourceAdapter object:
The following displays the command output that displays each
optional attribute and the data type for the attribute, and denotes
the default attributes:
Attribute Type Default
name String
description 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 J2CActivationSpec
properties Property
- Set up the attributes of interest.
Determine
the attributes to configure for the J2C resource adapter. In the following
examples, the commands set the RAR file path to the rarFile variable
and the name and description configuration options to the option variable:
- Create a resource adapter.
Use the installResourceAdapter
command for the AdminConfig object to install the resource adapter
with the previously set configuration options, as the following examples
demonstrate:
Using Jacl:
$AdminConfig installResourceAdapter $rarFile mynode $option
Using Jython:
AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
Example output:
RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
- Save the configuration changes. See the topic Saving configuration
changes with the wsadmin tool for more information.
- In a network deployment environment only,
synchronize the node. See the topic Synchronizing nodes with the wsadmin
tool for more information.