46/461

## create-jndi-resource

registers a JNDI resource

Synopsis

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

Description

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

This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--target`

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

  Note:

  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.

  `server`

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

  `domain`

    Creates the resource for the domain

  cluster-name

    Creates the resource for every server instance in the cluster

  instance-name

    Creates the resource for a particular server instance

`--restype`

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

`--factoryclass`

  The class that creates the JNDI resource.

`--jndilookupname`

  The lookup name that the external container uses.

`--enabled`

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

`--description`

  The text that provides details about the JNDI resource.

`--property`

  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. GlassFish Server itself does not define any properties for configuring a JNDI resource.

Operands

jndi-name

  The unique name of the JNDI resource to be created.

Examples

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

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

delete-jndi-resource(1), list-jndi-resources(1), create-resource-ref(1)

asadmin(1M)