Registers a JNDI resource.


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


The create-jndi-resource subcommand registers a JNDI resource.

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.


This option specifies the target for which you are registering a JNDI resource. Valid values for target are described below.

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.

Creates the resource for the default server instance. This value is the default.


Creates the resource for the domain


Creates the resource for every server instance in the cluster


Creates the resource for a particular server instance


The JNDI resource type. Valid values are topic or queue.


The class that creates the JNDI resource.


The lookup name that the external container uses.


Determines whether the resource is enabled at runtime. Default is true.


The text that provides details about the JNDI resource.


Optional properties for configuring the resource. Each property is specified as a name-value pair. The available properties are specific to the implementation that is specified by the --factoryclass option and are used by that implementation. Payara Server itself does not define any properties for configuring a JNDI resource.



The unique name of the JNDI resource to be created.


Example 1 Creating a JNDI Resource

This example creates the JNDI resource my-jndi-resource for the default server instance.

asadmin> create-jndi-resource
--restype com.example.jndi.MyResourceType
--factoryclass com.example.jndi.MyInitialContextFactoryClass
--jndilookupname remote-jndi-name
--description "sample JNDI resource" my-jndi-resource
JNDI resource my-jndi-resource created.
Command create-jndi-resource executed successfully.

Exit Status


subcommand executed successfully


error in executing the subcommand

See Also