asadmin-create-connector-connection-pool(1AS)			   User Commands		     asadmin-create-connector-connection-pool(1AS)

NAME

       asadmin-create-connector-connection-pool, create-connector-connection-pool - adds a connection pool with the specified connection pool name

SYNOPSIS

       create-connector-connection-pool  --user admin_user [--password admin_password] [--host localhost] [--port 4848] [--secure|-s] [--password-
       file filename] [--terse=false] [--echo=false] [--interactive=true] [--steadypoolsize 8] [--maxpoolsize 32] [--maxwaittime 3000]	[--poolre-
       size  2]  [--idletimeout  300] [--failallconnections=false]--raname resource_adapter_name --connectiondefinition connection-definition_name
       [--property name=value[:name=value]*] pool_name

       Adds a new connector connection pool. Before you can add a new connector connection pool, you must first deploy the associated RAR file.

       This command is supported in remote mode only.

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.

       --steadypoolsize        minimum and initial number of connections maintained in the pool (default is 8).

       --maxpoolsize	       maximum number of connections that can be created to satisfy client requests (default is 32).

       --maxwaittime	       amount  of time, in milliseconds, that a caller will have to wait before a connection is created if a connection is
			       not available. If set to 0 the caller is blocked indefinately until a resource is  available  or  an  error  occurs
			       (default is 60000).

       --poolresize	       the number of connections to be removed when idletimeout timer expires. Connections that have idled for longer than
			       the timeout are candidates for removal. When the pool size  reaches  the  steadypoolsize,  the  connection  removal
			       stops.

       --idletimeout	       the  maximum time that a connection can remain idle in the pool. After this amount of time, the pool can close this
			       connection (default is 300).

       --failallconnections    if true, closes all connections in the pool if a single validation check fails. This parameter is mandatory only if
			       the  is-connection-validation-required  is  set	to  true.  Legal values are: on, off, yes, no, 1, 0, true or false
			       (default is false).

       --raname 	       module name of the deployed resource adapter. In case of a resource adapter that is embedded in an application, the
			       raname will be appname#raname.

       --connectiondefinition  identifies  one	of the connection definitions in the deployment descriptor of a resource adapter. Value of connec-
			       tionfactory-interface sub-element in the connection-definition element.

       --property	       name/value pair of the configuration properties of the managedconnectionfactory-class of  the  connectiondefinition
			       for  which  the	pool is being created. The UserName and Password are accepted by default for all pools. The escape
			       character "

OPERANDS

       pool_name	       name of the connection pool to be created.

       Example 1: Using create-connector-connection-pool

       The JMS resource adapter that is prepackaged with the application server is used for this example. Before you can add a new connector  con-
       nection pool, you must first deploy the associated RAR file.

       To deploy the RAR file:

       asadmin> deploy --user admin --password adminadmin jmsra.rar
       Command deploy executed successfully

       asadmin> create-connector-connection-pool --user admin1
       --password adminadmin1 --steadypoolsize 20 --maxpoolsize 100 --poolresize 2
       --maxwait 60000 --raname jmsra --connectiondefinition javax.jms.QueueConnectionFactory
       --property UserName=guest:Password=guest jms/qConnPool
       Command create-connector-connection-pool executed successfully

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-deploy(1AS), asadmin-delete-connector-connection-pool(1AS), asadmin-list-connector-connection-pools(1AS)

J2EE 1.4 SDK							    March 2004			     asadmin-create-connector-connection-pool(1AS)