cscsvstop (Stopping an HCSC server)
- Organization of this page
Format
cscsvstop [-h]
-user login-user-ID
-pass login-password
{-csc HCSC-server-name|-cluster cluster-name}
[{-logical logical-server-name|-system}]
[-force]
Function
Stops the HCSC server.
By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.
For details on how to use this command, see the following locations in the Service Platform Setup and Operation Guide according to the purpose of use:
-
5.3.37 Terminating the HTTP Server
-
5.3.38 Terminating the HCSC Server
-
5.3.39 Terminating PRF
Arguments
-h
Displays the usage of commands. When you specify this option, all other options are ignored even if specified.
-user login-user-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the user ID that is used to log in to HCSC-Manager.
-pass login-password ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the password that is used to log in to HCSC-Manager.
-csc HCSC-server-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the name of the HCSC server to be stopped.
-cluster cluster-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the name of the cluster wherein the HCSC servers are to be stopped in a batch. An error occurs if you specify the -cluster option when the cluster type is HA.
-logical logical-server-name ~ <one-byte alphanumeric characters, underscores (_), and hyphens (-)> ((1 to 128 characters))
Specifies the name of the logical server to be stopped. The following table describes the types of logical servers set up with this option and their operations. Note that when you specify this option, the HCSC servers will not stop and the -force option is disabled.
|
No. |
Type of specified logical server |
Operation |
|---|---|---|
|
1 |
PRF |
Stops PRF. |
|
2 |
Smart Agent |
Stops Smart Agent. |
|
3 |
CTM Domain Manager |
Stops CTM Domain Manager. |
|
4 |
CTM daemon |
Stops the CTM daemon. |
|
5 |
J2EE server |
Stops a J2EE server.# |
|
6 |
Web server |
Stops a Web server. |
- #
-
Execute the command when the HCSC server is not running.
-system
Simultaneously stops the logical server defined in cscmng.server.HCSC-server-name.system in the HCSC-Manager definition file and the HCSC server.
-force
Forcibly stops an HCSC server even if the standard reception or user-defined reception is running. The logical J2EE server on which the HCSC server runs will stop normally.
Examples of input
- (1) To stop the HCSC server HCSC
cscsvstop -user admin -pass admin -csc HCSC
- (2) To forcefully stop all the HCSC servers in the cluster Cluster in a batch
cscsvstop -user admin -pass admin -cluster Cluster -force
- (3) To simultaneously stop the HCSC servers in the cluster Cluster and logical servers, in a batch
cscsvstop -user admin -pass admin -cluster Cluster -system
- (4) To stop the logical server PRF in the cluster Cluster, in a batch
cscsvstop -user admin -pass admin -cluster Cluster -logical PRF
- (5) To stop the J2EE server J2EEServer on the HCSC server HCSC
cscsvstop -user admin -pass admin -csc HCSC -logical J2EEServer
Return values
|
Return value |
Meaning |
|---|---|
|
0 |
The command terminated normally. |
|
1 |
The command terminated abnormally. |
|
2 |
A communication timeout occurred. |
|
3 |
An exclusion error occurred. |
|
9 |
An error occurred when checking the execution permission. |
Notes
-
Execute this command for a running HCSC server.
-
If an error occurs when you specify the -cluster option, check the results with the cscstatus command, eliminate the cause of the error, and then re-execute the command.