cjresumepool (restart member connection pool)
- Organization of this page
Format
cjresumepool [server-name] [-nameserver provider-URL]
-resname resource-adapter-display-name
[-resname resource-adapter-display-name ...]
Function
This command restarts a specified member connection pool of the cluster connection pool. This command can restart multiple member connection pools concurrently. The command attempts to restart all specified member connection pools even if there are member connection pools for which restart fails. If even one member connection pool cannot be restarted, the command terminates abnormally.
You must execute this command in the 1.4 mode; if it is executed in the basic mode, it terminates abnormally.
When this command is executed for a resource adapter that is running, the command sets the member connection pool to the "restarting manually" status. If the warming up functionality for member connection pools is enabled, the command next pools the connections in the member connection pool and then places the member connection pool in running status.
When this command is executed for a resource adapter that is stopped, the command sets the member connection pool in "running reserved" status.
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 specifications, see 2.1.2 Provider URL in the manual uCosminexus Application Server Command Reference Guide.
- -resname resource-adapter-display-name
-
Specifies the display name of a member resource adapter that is to be restarted.
If the specified resource adapter is not a member resource adapter of the cluster connection pool, the command terminates abnormally.
This argument enables you to execute the command regardless of whether the specified resource adapter is running or stopped. However, whether or not the command can be executed depends on the status of the member connection pool, as shown in the following table:
Member connection pool status
Command executability
Suspended automatically status
Suspended manually status
Suspended automatically reserved status
Suspended manually reserved status
Can be executed
Running status
Running reserved status
Restarting automatically status
Restarting manually status
Blocked automatically status
Blocked manually status
Cannot be executed
Input examples
cjresumepool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member
Return values
- 0:
-
The command terminated normally.
- 1:
-
The command terminated abnormally.
- 2:
-
The command could not be executed because of an exclusion error.
- 3:
-
A timeout error occurred.
- 9:
-
The command could not be executed because there are no administrator privileges (in Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista).
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 application-name -name); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver application-name -name provider-URL).
-
When you specify a server name for the command argument, you must specify a character string that is consistent with the letter case of the server name specified for the cjsetup command. For details on the cjsetup command, see cjsetup (set up or unsetup J2EE server) in the manual uCosminexus Application Server Command Reference Guide.