Administering Connector Connection Pools

After a connector module has been deployed, you are ready to create a connector connection pool for it.

The following topics are addressed here:

• To Create a Connector Connection Pool

• To List Connector Connection Pools

• To Connect to (Ping) or Reset (Flush) a Connector Connection Pool

• To Update a Connector Connection Pool

• To Delete a Connector Connection Pool

To Create a Connector Connection Pool

Use the create-connector-connection-pool subcommand in remote mode to create a connector connection pool for a deployed connector module. When you are building the connector connection pool, certain data specific to the EIS will be required. The value in the mandatory --connectiondefintion option provides the EIS info.

Multiple connector resources can specify a single connection pool.

Creating a connector connection pool is a dynamic event and does not require server restart. However, there are some parameters that do require server restart. See Configuration Changes That Require Restart.

Before You Begin

Before creating the connector connection pool, the connector must be installed.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. Create the connector connection pool by using the create-connector-connection-pool(1) subcommand.

   Information about properties for the subcommand is included in this help page.

3. (Optional) If needed, restart the server.

   Some properties require server restart. See Configuration Changes That Require Restart. If your server needs to be restarted, see To Restart a Domain.

4. (Optional) You can verify that a connection pool is usable by using the ping-connection-pool subcommand.

   For instructions, see To Contact (Ping) a Connection Pool.

Example 13-1 Creating a Connector Connection Pool

This example creates the new jms/qConnPool pool for the javax.jms.QueueConnectionFactory connector module.

asadmin> create-connector-connection-pool --steadypoolsize 20 --maxpoolsize 100 
--poolresize 2 --maxwait 60000 --raname jmsra --connectiondefinition 
javax.jms.QueueConnectionFactory jms/qConnPool  
Command create-connector-connection-pool executed successfully

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help create-connector-connection-pool at the command line.

To List Connector Connection Pools

Use the list-connector-connection-pools subcommand in remote mode to list the pools that have been created.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the connector connection pools by using the list-connector-connection-pools(1) subcommand.

Example 13-2 Listing Connector Connection Pools

This example lists the existing connector connection pools.

asadmin> list-connector-connection-pools
jms/qConnPool
Command list-connector-connection-pools executed successfully

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help list-connector-connection-pools at the command line.

To Connect to (Ping) or Reset (Flush) a Connector Connection Pool

Use the ping-connection-pool or flush-connection-pool subcommands in remote mode to perform these tasks on a connection pools. See To Contact (Ping) a Connection Pool or To Reset (Flush) a Connection Pool for instructions.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. Connect to or reset a connector connection pool by using theflush-connection-pool(1) subcommand or the ping-connection-pool(1) subcommand.

To Update a Connector Connection Pool

Use the get and set subcommands to view and change the values of the connector connection pool properties.

1. List the connector connection pools by using the list-connector-connection-pools(1) subcommand.
2. View the properties of the connector connection pool by using the get(1) subcommand.

   For example:

   asadmin> get domain.resources.connector-connection-pool.conectionpoolname.*

3. Set the property of the connector connection pool by using the set(1) subcommand.

   For example:

   asadmin> set domain.resources.connector-connection-pool .conectionpoolname.validate-atmost-once-period-in-seconds=3

4. (Optional) If needed, restart the server.

   Some properties require server restart. See Configuration Changes That Require Restart. If your server needs to be restarted, see To Restart a Domain.

To Delete a Connector Connection Pool

Use the delete-connector-connection-pool subcommand in remote mode to remove a connector connection pool.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the connector connection pools by using the list-connector-connection-pools(1) subcommand.
3. If necessary, notify users that the connector connection pool is being deleted.
4. Delete the connector connection pool by using the delete-connector-connection-pool(1) subcommand.

Example 13-3 Deleting a Connector Connection Pool

This example deletes the connection pool named jms/qConnPool.

asadmin> delete-connector-connection-pool --cascade=false jms/qConnPool
Command delete-connector-connection-pool executed successfully

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help delete-connector-connection-pool at the command line.