Creates a custom resource.


asadmin [asadmin-options] create-custom-resource [--help]
--restype type --factoryclass classname
[--enabled={true|false}] [--description text]
[--property (name=value)[:name=value]*] jndi-name
[--target target]


The create-custom-resource subcommand creates a custom resource. A custom resource specifies a custom server-wide resource object factory that implements the javax.naming.spi.ObjectFactory interface.

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.


The target on which the custom resource you are creating will be available. Valid values are:


The resource will be available on the default server instance and all domains hosted on the instance. This is the default value.


The resource will be available on the specified domain only.


The resource will be available on every server instance in the cluster.


The resource will be available on the specified server instance only.

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.

The type of custom resource to be created. Specify a fully qualified type definition, for example javax.naming.spi.ObjectFactory. The resource type definition follows the format, xxx`.`xxx.


Factory class name for the custom resource. This class implements the javax.naming.spi.ObjectFactory interface.


Determines whether the custom resource is enable at runtime. Default is true.


Text providing details about the custom resource. This description is a string value and can include a maximum of 250 characters.


Optional attribute name/value pairs for configuring the resource.



The JNDI name of this resource.


Example 1 Creating a Custom Resource

This example creates a custom resource.

asadmin> create-custom-resource --restype topic
--factoryclass com.imq.topic
Custom Resource mycustomresource created.
Command create-custom-resource executed successfully.

Exit Status


subcommand executed successfully


error in executing the subcommand

See Also