Configure new J2C administrative objects

We can use scripting and wsadmin.sh to configure new J2C administrative objects.

Before starting this task, wsadmin.sh must be running. See the topic on starting wsadmin.sh.

To configure a J2C administrative object:

1. Identify the parent ID and assign it to the newra variable.

   • Jacl:

     set newra [$AdminConfig getid /Cell:mycell/Node:mynode/J2CResourceAdapter:RAR1/]

   • Jython:

     newra = AdminConfig.getid('/Cell:mycell/Node:mynode/J2CResourceAdapter:RAR1/')
     print newra

   Example output:

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

2. There are two ways to configure a new J2C administrative object. Perform one of the following:

   • Use the AdminTask object:

     1. List the administrative object interfaces:

        Jacl:

        $AdminTask listAdminObjectInterfaces $newra

        Using Jython:

        AdminTask.listAdminObjectInterfaces(newra)

        Example output:

        com.ibm.test.message.FVTMessageProvider

     2. Create a J2C administrative object:

        Jacl:

        $AdminTask createJ2CAdminObject $newra { -name ao1 -jndiName eis/ao1 -adminObjectInterface com.ibm.test.message.FVTMessageProvider }

        Using Jython:

        AdminTask.createJ2CAdminObject(newra, ['-name', 'ao1', '-jndiName', 'eis/ao1', '-adminObjectInterface', 'com.ibm.test.message.FVTMessageProvider'])

   • Use the AdminConfig object:

     1. Jacl:

        $AdminConfig required J2CAdminObject

        Using Jython:

        print AdminConfig. required('J2CAdminObject')

        Example output:

        Attribute Type
        adminObject AdminObject@

     2. If the resource adapter is JCA V1.5 and we have multiple administrative objects defined, it is required specified the administrative object attribute. If the resource adapter is JCA V1.5 and we have only one administrative object defined, it will be picked up automatically. If the resource adapter is JCA V1.0, we do not need to specify the administrative object attribute. Perform the following command to list the administrative objects defined by the resource adapter:

        Using Jacl:

        $AdminConfig list AdminObject $newra

        Using Jython:

        print AdminConfig.list('AdminObject', $newra)

     3. Set the administrative objects that we need to a variable:

        Using Jacl:

        set ao AdminObjectId
        set name [list name J2CAO1]
        set jname [jndiName eis/j2cao1]
        set j2caoAttrs [list $name $jname]

        Jython:

        ao = AdminObjectId
        name = ['name', 'J2CAO1']
        set jname = ['jndiName', eis/j2cao1]
        j2caoAttrs = [name, jname]

     4. If we are specifying the AdminObject attribute, also set up the following:

        Jacl:

        set cdattr [list adminObject $ao]

        Jython:

        cdattr = ['adminObject', ao]

     5. Create a J2C administrative object:

        Jacl:

        $AdminConfig create J2CAdminObject $newra $j2caoAttrs

        Using Jython:

        print AdminConfig.create('J2CAdminObject', newra, j2caoAttrs)

   Example output:

   J2CAO1(cells/mycell/nodes/mynode|resources.xml#J2CAdminObject_1)

3. Save the configuration changes.

4. Synchronize the node.

Related tasks

Start the wsadmin scripting client

Use the wsadmin scripting AdminConfig object for scripted administration

Use the wsadmin scripting AdminTask object for scripted administration

Saving configuration changes with wsadmin.sh

Synchronize nodes using wsdmin.sh

Commands for the AdminConfig object

Commands (AdminTask)