ping-connection-pool
Tests if a connection pool is usable.
Synopsis
asadmin [asadmin-options] ping-connection-pool [--help]
pool_name
[--appname application [--modulename module]Description
The ping-connection-pool subcommand tests if an existing JDBC or connector connection pool is usable . For example, if you create a new
JDBC connection pool for an application that is expected to be deployed later, the JDBC pool is tested with this subcommand before deploying the application.
Before testing availability of a connection pool, you must create the connection pool with authentication and ensure that the server or database is started.
This subcommand is supported in remote mode only.
Application Scoped Resources
The ping-connection-pool subcommand can target resources that are scoped to a specific application or module, as defined in the
glassfish-resources.xml or payara-resources.xml for the Payara Server domain.
-
To reference the
jndi-namefor an application scoped resource, perform the lookup using thejava:appprefix. -
To reference the
jndi-namefor a module scoped resource, perform the lookup using thejava:moduleprefix.
The jndi-name for application-scoped-resources or module-scoped-resources are specified using the format
java:app/`jdbc/myDataSource or `java:module/`jdbc/myModuleLevelDataSource.
Options
- asadmin-options
-
Options for the
asadminutility. For information about these options, see theasadminhelp page. --help-?-
Displays the help text for the subcommand.
--appname-
Name of the application in which the application scoped resource is defined.
--modulename-
Name of the module in which the module scoped resource is defined.
Examples
Example 1 Contacting a Connection Pool
This example tests to see if the connection pool named DerbyPool is usable.
asadmin> ping-connection-pool DerbyPool
Command ping-connection-pool executed successfully