Adds the administered object with the specified JNDI name for a resource adapter.


asadmin [asadmin-options] create-admin-object [--help]
[--target target]
--restype restype
[--classname classname]
--raname raname
[--description description]
[--property name=value[:name=value]*]


The create-admin-object subcommand creates the administered object with the specified JNDI name and the interface definition for a resource adapter.

This subcommand is supported in remote mode only.



Options for the asadmin utility. For information about these options, see the asadmin help page.


Displays the help text for the subcommand.


Specifies the target on which you are creating the administered object. Valid values are as follows:


Creates the administered object for the default server instance server and is the default value.


Creates the administered object for the named configuration.


Creates the administered object for every server instance in the cluster.


Creates the administered object for a particular server instance.

The resource is always created for the domain as a whole, but the resource-ref for the resource is only created for the specified --target. This means that although the resource is defined at the domain level, it is only available at the specified target level. Use the create-resource-ref subcommand to refer to the resource in multiple targets if needed.

Specifies the interface definition for the administered object. The resource type must be an interface definition that is specified in the ra.xml file of the resource adapter.


Specifies the class name of the administered object. Required if multiple administered objects use the same interface definition.


Specifies the name of the resource adapter associated with this administered object.


Specifies if this object is enabled. Default is true.


Text string describing the administered object.


Description of the name/values pairs for configuring the resource. Dependent on the resource adapter. For JMS properties, see create-jms-resource for JMS destination resources.



JNDI name of the administered object to be created.


Example 1 Creating an Administered Object

In this example, jmsra is a system resource adapter with the admin object interfaces, jakarta.jms.Queue and jakarta.jms.Topic.

asadmin> create-admin-object --restype jakarta.jms.Queue
--raname jmsra --description "sample administered object"
--property Name=sample_jmsqueue jms/samplequeue
Command create-admin-object executed successfully

Exit Status


subcommand executed successfully


error in executing the subcommand

See Also