Set new J2C resource adapters using scripting

Use wsadmin to configure 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.

A RAR file, which is often called a J2EE Connector Architecture (JCA) connector, must comply with the JCA Specification. Meet these requirements by using a supported assembly tool to assemble a collection of JAR files, other runnable components, utility classes, and so on, into a deployable RAR file. Then we are ready to install the RAR file in Application Server.

There are two ways to complete this task. This page uses the AdminConfig object to install resource adapters. Alternatively, we can use the installJ2CResourceAdapter script in the AdminJ2C script library to install a J2C resource adapter in the configuration...

AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")

The scripting library provides a set of procedures to automate the most common administration functions. We can run each script procedure individually, or combine several procedures to quickly develop new scripts.

 

1. Launch the wsadmin scripting tool using the Jython scripting language.

2. Identify the configuration ID of the node to which the resource adapter is installed, as the following examples demonstrate:
   • Jacl...

     set node [$AdminConfig getid /Cell:mycell/Node:mynode/]

   • Jython...

     node = AdminConfig.getid('/Cell:mycell/Node:mynode/')
     print node

   For example...

   mynode(cells/mycell/nodes/mynode|node.xml#Node_1)

3. 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:

   • Jacl...

     $AdminConfig defaults J2CResourceAdapter

   • Jython...

     print AdminConfig.defaults('J2CResourceAdapter')

   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 name String description String classpath String nativepath String providerType String archivePath String threadPoolAlias String propertySet J2EEResourcePropertySet jaasLoginConfiguration JAASConfigurationEntry deploymentDescriptor Connector connectionDefTemplateProps ConnectionDefTemplateProps activationSpecTemplateProps ActivationSpecTemplateProps j2cAdminObjects J2CAdminObject adminObjectTemplateProps AdminObjectTemplateProps j2cActivationSpec J2CActivationSpec

4. 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:

   • Jacl...

     set rarFile c:/currentScript/cicseci.rar set option {-rar.name RAR1 -rar.desc "New resource adapter"}

   • Jython...

     rarFile = 'c:/currentScript/cicseci.rar' option = '[-rar.name RAR1 -rar.desc "New resource adapter"]'

5. 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:

   • Jacl...

     $AdminConfig installResourceAdapter $rarFile mynode $option

   • Jython...

     AdminConfig.installResourceAdapter(rarFile, 'mynode', option)

   For example...

   RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)

6. Save the configuration changes...

   AdminConfig.save()

7. Synchronize the node. Use the syncActiveNode or syncNode scripts in the AdminNodeManagement script library to propagate the configuration changes to node or nodes.

   • Use the syncActiveNodes script to propagate the changes to each node in the cell...

     AdminNodeManagement.syncActiveNodes()

   • Use the syncNode script to propagate the changes to a specific node, as the following example demonstrates:

     AdminNodeManagement.syncNode("myNode")

Relational resource adapters and JCA

 

Related tasks

Install a resource adapter archive
Use the AdminConfig object for scripted administration

 

Related

J2C configuration scripts
Commands for the AdminConfig object

 

Related information