cjlistpool (list connection pools)

Format

For specifying resource adapters deployed as J2EE resource adapters

cjlistpool [server-name] [-nameserver provider-URL]
      -resname resource-adapter-display-name
      [-resname resource-adapter-display-name ...]

For specifying resource adapters included and used in an application

cjlistpool [server-name] [-nameserver provider-URL]
      -name application-name
      -resname resource-adapter-display-name
      [-resname resource-adapter-display-name ...]

For specifying all resource adapters

cjlistpool [server-name] [-nameserver provider-URL] -resall

To Page Top

Function

For specifying selected resource adapters

For specifying a resource adapter deployed as a J2EE resource adapter

This command outputs the connection pool information for the specified J2EE resource adapters as the standard output.

The command can display connection pool information for multiple resource adapters concurrently. This command attempts to display information for all resource adapters even if there are resource adapters that cannot be displayed.

For specifying a resource adapter included and started in an application

This command outputs the connection pool status of the resource adapter included in the specified application as the standard output.

The command can display connection pool status for multiple resource adapters concurrently. This command attempts to display status for all resource adapters even if there are resource adapters that cannot be displayed.

For specifying all resource adapters

This command outputs to the standard output connection pool information for all running resource adapters.

Note that invalid connection pools are not output.

To Page Top

Arguments

server-name

Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.

-nameserver provider-URL

Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:

protocol-name: : host-name: port-number

For details on the specification items, see 2.1.2 Provider URL.

-resname resource-adapter-display-name

Specifies the display name of a resource adapter to be displayed.

In Connector 1.5, this argument is specified as resource-adapter-display-name!connection-definition-identifier.

-name application-name

Specifies the name of application including the resource adapter to be displayed.

If this argument is omitted, the name of resource adapter deployed as J2EE resource adapter is displayed.

-resall

Specifies that all resource adapters are to be displayed.

To Page Top

Output format

To Page Top

Input examples

Format 1

cjlistpool MyServer -resname Rar1

Format 2

cjlistpool MyServer -name App1 -resname Rar1

Format 3

cjlistpool MyServer -resall

To Page Top

Return values

0:

The command terminated normally.

1:

The command terminated abnormally.

3:

A timeout error occurred.

9:

The command could not be executed because there are no administrator privileges (in Windows).

To Page Top

Notes

• When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify provider-URL -nameserver); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver resource-adapter-display-name -resname provider-URL).

• When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).

To Page Top