cjsuspendpool (suspend member connection pool)
- Organization of this page
Format
cjsuspendpool [server-name] [-nameserver provider-URL] -resname resource-adapter-display-name [-resname resource-adapter-display-name ...]
Function
This command suspends a member connection pool of the cluster connection pool. The command can suspend multiple member connection pools concurrently. The command attempts to suspend all specified member connection pools even if there are member connection pools for which suspension fails. If even one member connection pool cannot be suspended, the command terminates abnormally.
This command is effective only when it is executed in the 1.4 mode. If the command 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 "blocked manually" status and terminates. Next, suspension processing is executed in the J2EE server. After suspension processing is completed, the member connection pool is set to "suspended manually" status.
When this command is executed for a resource adapter that is stopped, the command sets the member connection pool to "suspended manually 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 suspended.
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
Running status
Running reserved status
Suspended automatically status
Suspended automatically reserved status
Can be executed
Suspended manually status
Suspended manually reserved status
Restarting automatically status
Restarting manually status
Blocked automatically status
Blocked manually status
Cannot be executed
Input examples
cjsuspendpool 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 data-source-display-name -resname); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver data-source-display-name -resname 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.