org.glassfish.jdbc.admin.cli.create-jdbc-resource.1 Maven / Gradle / Ivy
The newest version!
create-jdbc-resource(1) asadmin Utility Subcommands create-jdbc-resource(1)
NAME
create-jdbc-resource - creates a JDBC resource with the specified JNDI
name
SYNOPSIS
create-jdbc-resource [--help]
--connectionpoolid connectionpoolid
[--enabled={false|true}]
[--description description]
[--property (property=value)[:name=value]*]
[--target target]
jndi_name
DESCRIPTION
The create-jdbc-resource subcommand creates a new JDBC resource.
This subcommand is supported in remote mode only.
OPTIONS
--help, -?
Displays the help text for the subcommand.
--connectionpoolid
The name of the JDBC connection pool. If two or more JDBC resource
elements point to the same connection pool element, they use the
same pool connection at runtime.
--enabled
Determines whether the JDBC resource is enabled at runtime. The
default value is true.
--description
Text providing descriptive details about the JDBC resource.
--property
Optional attribute name/value pairs for configuring the resource.
--target
This option helps specify the target to which you are deploying.
Valid values are:
server
Deploys the component to the default server instance. This is
the default value.
domain
Deploys the component to the domain.
cluster_name
Deploys the component to every server instance in the cluster.
instance_name
Deploys the component to a particular server instance.
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. |
+----------------------------------------+
OPERANDS
jndi_name
The JNDI name of this JDBC resource.
EXAMPLES
Example 1, Creating a JDBC Resource
This example creates a JDBC resource named jdbc/DerbyPool.
asadmin> create-jdbc-resource
--connectionpoolid sample_derby_pool jdbc/DerbyPool
Command create-jdbc-resource executed successfully.
EXIT STATUS
0
subcommand executed successfully
1
error in executing the subcommand
SEE ALSO
delete-jdbc-resource(1), list-jdbc-resources(1), create-resource-ref(1)
asadmin(1M)
Jakarta EE 10 10 Feb 2011 create-jdbc-resource(1)