create-persistence-resource.1


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
SEE ALSO

NAME

create-persistence-resource - registers the persistence resource

SYNOPSIS

create-persistence-resource --user admin_user [ --password admin_password ] [ --host localhost ] [ --port 4848 ] [ --secure|-s ] [ --passwordfile filename ] [ --terse=false ] [ --echo=false ] [ --interactive=true ] [ --jdbcjndiname jdbc_jndiname | --connectionpoolid id ] [ --factoryclass classname ][ --enabled=true ] [ --description text ] [ --property (name=value)[ :name=value ]* ] jndi_name

DESCRIPTION

Registers the persistence resource. This command is supported in remote mode only.

The --jdbcjndiname option and --connectionpoolid option are mutually exclusive; only one should be used.

OPTIONS

--user: authorized domain application server administrative username.
--password: password to administer the domain application server.
--host: machine name where the domain application server is running.
--port: port number of the domain application server listening for administration requests.
--secure: if true, uses SSL/TLS to communicate with the domain application server.
--passwordfile: file containing the domain application server password.
--terse: indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.
--echo: setting to true will echo the command line statement on the standard output. Default is false.
--interactive: if set to true (default), only the required password options are prompted.
--jdbcjndiname: JDBC resource with which database connections are obtained. Must be the name of one of the pre-created JDBC resources.
--connectionpoolid: name of the JDBC connection pool. If two or more JDBC resource elements point to the same connection pool element, they will use the same pool connections at runtime.
--factoryclass: class that creates persistence manager instance.
--enabled: determines whether the resource is enabled at runtime or not.
--description: text description of the persistence resource.
--property: optional attribute name/value pairs for configuring the persistence resource.

OPERANDS

jndi_name: JNDI name of the persistence resource.

EXAMPLES

Example 1. Using create-persistence-resource

asadmin> create-persistence-resource --user admin1 --password adminadmin1
--jdbcjndiname sample_jndi_resource --factoryclass "com.pmf.class" 
sample_persistence_resource
Command create-persistence-resource executed successfully

Where: sample_persistence_resource is the persistence manager factory resource created.

EXIT STATUS

0: command executed successfully
1: error in executing the command