Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)

JCAManagement command group

Use the Jython or Jacl scripting languages to configure messaging with scripting. The commands and parameters in the JCA management group can be used to create and manage resource adapters, Java EE Connector Architecture (J2C) activation specifications, administrative objects, connection factories, administrative object interfaces, and message listener types.

The JCAManagement command group includes the following commands:

• copyResourceAdapter

• createJ2CActivationSpec

• createJ2CAdminObject

• createJ2CConnectionFactory

• listAdminObjectInterfaces

• listConnectionFactoryInterfaces

• listJ2CActivationSpecs

• listJ2CAdminObjects

• listJ2CConnectionFactories

• listMessageListenerTypes

copyResourceAdapter

Use the copyResourceAdapter command to create a J2C resource adapter under the scope that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

-name

Indicates the name of the new J2C resource adapter. This parameter is required.

-scope

Indicates the scope object ID. This parameter is required.

-useDeepCopy

If you set this parameter to true, all of the J2C connection factory, J2C activation specification, and J2C administrative objects will be copied to the new J2C resource adapter (deep copy). If you set this parameter to false, the objects are not created (shallow copy). The default is false.

Examples

Batch example...

### Jacl

$AdminTask copyResourceAdapter $ra [subst {-name newRA -scope $scope}]

### Jython string

AdminTask.copyResourceAdapter(ra, '[-name newRA -scope scope]')

• Jython list:

  AdminTask.copyResourceAdapter(ra, ['-name', 'newRA', '-scope', 'scope'])
  

Interactive example...

### Jacl

$AdminTask copyResourceAdapter {-interactive}

### Jython

AdminTask.copyResourceAdapter('-interactive')

createJ2CActivationSpec

Use the createJ2CActivationSpec command to create a J2C activation specification under a J2C resource adapter and the attributes that you specify. Use the messageListenerType parameter to indicate the activation specification that is defined for the J2C resource adapter.

Target object J2C Resource Adapter object ID

Parameters and return values

- messageListenerType

Identifies the activation specification for the J2C activation specification to be created. Use this parameter to identify the activation specification template for the J2C resource adapter that you specify.

-name

Indicates the name of the J2C activation specification that you are creating.

-jndiName

Indicates the name of the JNDI.

-destinationJndiName

Indicates the name of the JNDI of corresponding destination.

-authenticationAlias

Indicates the authentication alias of the J2C activation specification that you are creating.

-description

Description of the created J2C activation specification.

Examples

Batch example...

### Jacl

$AdminTask createJ2CActivationSpec $ra {-name J2CAct Spec -jndiName eis/ActSpec1
 -messageListenerType javax.jms.MessageListener }

### Jython string

AdminTask.createJ2CActivationSpec(ra, '[-name J2CActSpec -jndiName eis/ActSpec1
 -messageListenerType javax.jms.MessageListener]')

• Jython list:

  AdminTask.createJ2CActivationSpec(ra, ['-name', 'J2CActSpec', '-jndiName', 'eis/ActSpec1',
   '-messageListenerType', 'javax.jms.MessageListener'])
  

Interactive example...

### Jacl

$AdminTask createJ2CActivationSpec {-interactive}

### Jython

AdminTask.createJ2CActivationSpec('-interactive')

createJ2CAdminObject

Use the createJ2CAdminObject command to create an administrative object under a resource adapter with attributes that you specify. Use the administrative object interface to indicate the administrative object that is defined in the resource adapter.

Target object J2C Resource Adapter object ID

Parameters and return values

-adminObjectInterface

Administrative object interface to identify the administrative object for the resource adapter that you specify. This parameter is required.

-name

Indicates the name of the administrative object.

-jndiName

Name of the JNDI.

-description

Description of the created J2C admin object.

Examples

Batch example...

### Jacl

$AdminTask createJ2CAdminObject $ra {-adminObjectInterface fvt.adapter.message.FVTMessageProvider
 -name J2CA01 -jndiName eis/J2CA01}

### Jython string

AdminTask.createJ2CAdminObject(ra, '[-adminObjectInterface fvt.adapter.message.FVTMessageProvider
 -name J2CA01 -jndiName eis/J2CA01]')

• Jython list:

  AdminTask.createJ2CAdminObject(ra, ['-adminObjectInterface',
   'fvt.adapter.message.FVTMessageProvider', '-name', 'J2CA01', '-jndiName', 'eis/J2CA01'])
  

Interactive example...

### Jacl

$AdminTask createJ2CAdminObject {-interactive}

### Jython

AdminTask.createJ2CAdminObject('-interactive')

createJ2CConnectionFactory

Use the createJ2CConnectionFactory command to create a Java 2 connection factory under a Java 2 resource adapter and the attributes that you specify. Use the connection factory interfaces to indicate the connection definitions that are defined for the Java 2 resource adapter.

Target object J2C Resource Adapter object ID

Parameters and return values

-connectionFactoryInterface

Identifies the connection definition for the Java 2 resource adapter that you specify. This parameter is required.

-name

Indicates the name of the connection factory.

-jndiName

Indicates the name of the JNDI.

-description

Description of the created J2C connection factory.

Examples

Batch example...:

### Jacl

$AdminTask createJ2CConnectionFactory $ra {-connectionFactoryInterface javax.sql.DataSource
-name J2CCF1 -jndiName eis/J2CCF1}

### Jython string

AdminTask.createJ2CConnectionFactory(ra, '[-connectionFactoryInterface javax.sql.DataSource
-name J2CCF1 -jndi Name eis/J2CCF1]')

• Jython list:

  AdminTask.createJ2CConnectionFactory(ra, ['-connectionFactoryInterface',
   'javax.sql.DataSource', '-name', 'J2CCF1', '-jndiName', 'eis/J2CCF1'])
  

Interactive example...

### Jacl

$AdminTask createJ2CConnectionFactory {-interactive}

### Jython

AdminTask.createJ2CConnectionFactory('-interactive')

listAdminObjectInterfaces

Use the listAdminObjectInterfaces command to list the administrative object interfaces that are defined under the resource adapter that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

• Parameters: None

• Returns: A list of administrative object interfaces.

Examples

Batch example...:

### Jacl

$AdminTask listAdminObjectInterfaces $ra

### Jython string

AdminTask.listAdminObjectInterfaces(ra)

• Jython list:

  AdminTask.listAdminObjectInterfaces(ra)
  

Interactive example...

### Jacl

$AdminTask listAdminObjectInterfaces {-interactive}

### Jython

AdminTask.listAdminObjectInterfaces('-interactive')

listConnectionFactoryInterfaces

Use the listConnectionFactoryInterfaces command to list all of the connection factory interfaces that are defined under the Java 2 connector resource adapter that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

• Parameters: None

• Returns: A list of connection factory interfaces.

Examples

Batch example...:

### Jacl

$AdminTask listConnectionFactoryInterfaces $ra

### Jython string

AdminTask.listConnectionFactoryInterfaces(ra)

• Jython list:

  AdminTask.listConnectionFactoryInterfaces(ra)
  

Interactive example...

### Jacl

$AdminTask listConnectionFactoryInterfaces {-interactive}

### Jython

AdminTask.listConnectionFactoryInterfaces('-interactive')

listJ2CActivationSpecs

Use the listJ2CActivationSpecs command to list the activation specifications that are contained under the resource adapter and message listener type that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

-messageListenerType

Message listener type for the resource adapter for which you are making a list. This parameter is required.

Examples

Batch example...

### Jacl

$AdminTask listJ2CActivationSpecs $ra {-messageListener Type javax.jms.MessageListener}

### Jython string

AdminTask.listJ2CActivationSpecs(ra, '[-messageListener Type javax.jms.MessageListener]')

• Jython list:

  AdminTask.listJ2CActivation Specs(ra, ['-messageListener Type', 'javax.jms.MessageListener'])
  

Interactive example...

### Jacl

$AdminTask listJ2CActivationSpecs {-interactive}

### Jython

AdminTask.listJ2CActivationSpecs('-interactive')

listJ2CAdminObjects

Use the listJ2CAdminObjects command to list administrative objects that contain the administrative object interface that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

-adminObjectInterface

Administrative object interface for which you want to list. This parameter is required.

Examples

Batch example...

### Jacl

$AdminTask listJ2CAdminObjects $ra {-adminObjectInterface
 fvt.adaptor.message.FVTMessageProvider}

### Jython string

AdminTask.listJ2CAdminObjects(ra, '[-adminObjectInterface
 fvt.adaptor.message.FVTMessageProvider]')

Interactive example...

### Jacl

$AdminTask listJ2CAdminObjects {-interactive}

### Jython

AdminTask.listJ2CAdminObjects('-interactive')

listJ2CConnectionFactories

Use the listJ2CConnectionFactories command to list the Java 2 connector connection factories under the resource adapter and connection factory interface that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

-connectionFactoryInterface

Indicates the name of the connection factory to list. This parameter is required.

Examples

Batch example...

### Jacl

$AdminTask listJ2CConnectionFactories $ra {-connectionFactoryInterface javax.sql.DataSource}

### Jython string

AdminTask.listJ2CConnectionFactories(ra, '[-connectionFactoryInterface javax.sql.DataSource]')

• Jython list:

  AdminTask.listJ2CConnectionFactories(ra, ['-connectionFactoryInterface',
   'javax.sql.DataSource'])
  

Interactive example...

### Jacl

$AdminTask listJ2CConnectionFactories {-interactive}

### Jython

AdminTask.listJ2CConnectionFactories('-interactive')

listMessageListenerTypes

Use the listMessageListenerTypes command to list the message listener types that are defined under the resource adapter that you specify.

Target object J2C Resource Adapter object ID

Parameters and return values

• Parameters: None

• Returns: A list of message listener types.

Examples

Batch example...:

### Jacl

$AdminTask listMessageListenerTypes $ra

### Jython string

AdminTask.listMessageListenerTypes(ra)

• Jython list:

  AdminTask.listMessageListenerTypes(ra)
  

Interactive example...

### Jacl

$AdminTask listMessageListenerTypes {-interactive}

### Jython

AdminTask.listMessageListenerTypes('-interactive')

Configure new J2C administrative objects using wsadmin.sh
Configure new J2C activation specifications using wsadmin.sh
Configure new J2C resource adapters using wsadmin.sh
Use the wsadmin scripting AdminTask object for scripted administration

Related

Commands using wsadmin.sh

+

Search Tips   |   Advanced Search