5.3.38 Terminating the HCSC Server

(a) Using windows

To terminate the HCSC server using windows in the operating environment:

1. In the tree view, double-click the HCSC server to be terminated.

   Information about the chosen HCSC server is displayed in the editor area.

2. In the editor area, choose the Operations tab.

   The Operations page displays information about operations of the HCSC server you chose in step 1.

   For details about the Operations page for an HCSC server, see 4.4 Operations Page in the manual uCosminexus Service Platform Reference Guide.

3. Check the information displayed in the Operations page, and then, under HCSC-Server, click the Stop button.

   A dialog box confirming termination of the HCSC server is displayed.

4. Check the information displayed in the dialog box and then click the OK button.

   HCSC server termination processing begins. Log information during termination processing is displayed in the console view.

   If the Cancel button is clicked, the system returns to the Operations page without executing termination processing.

   When HCSC server termination processing is completed, a dialog box indicating the execution result is displayed.

5. Check the dialog box indicating the execution result.

   If termination processing was successful:

   Click the OK button to return to the Operations page.

   On the Operations page, HCSC server status is set to inactive. Also, the Stop button is disabled and the Start button is enabled.

   If termination processing failed:

   The dialog box displays the nature of the error. Check the message ID provided in the detailed information, and then take appropriate action.

(b) Using commands

To terminate the HCSC server, execute the cscsvstop command or cscutil command in the operating environment. To terminate the HCSC servers in the cluster in a batch or to terminate the logical server, execute the cscsvstop command.

Use the cscsvstop and cscutil commands in the following cases:

• cscsvstop command

  To terminate the HCSC server in the operating environment where the corresponding repository exists.

• cscutil command

  To terminate the HCSC server in an environment (for example, execution environment directly operating in JP1) where the cscutil command can be used and where the corresponding repository does not exist.

The following describes how to execute the above commands:

Using the cscsvstop command

Execute the cscsvstop command in the operating environment.

For details about the cscsvstop command, see cscsvstop (Stopping an HCSC server) in the manual uCosminexus Service Platform Reference Guide.

The execution format of the cscsvstop command is described below:

To terminate the HCSC servers in the cluster in a batch

Specify the cluster name and execute the command.

cscsvstop -user login-user-ID -pass login-password -cluster cluster-name

If you want to terminate the logical server when you terminate the HCSC servers in the cluster, specify the -system option. However, the logical server must be registered in the HCSC-Manager definition files. For details on registering the logical server, see 5.3.1(1) Preparation before starting operations.

cscsvstop -user login-user-ID -pass login-password -cluster cluster-name -system

Furthermore, if you want to terminate only the specified logical server without terminating the HCSC server, specify the -logical option.

cscsvstop -user login-user-ID -pass login-password -cluster cluster-name -logical logical-server-name

Note that when terminating the HTTP Server within the logical server by specifying the -system or -logical option, there are two types of termination methods, standard termination and planned termination. For details about how to terminate the HTTP Server, see 5.3.37 Terminating the HTTP Server.

To terminate each HCSC server individually:

Specify the HCSC server name and execute the command.

cscsvstop -user login-user-ID -pass login-password -csc HCSC-server-name

If you want to terminate the logical server when you terminate the HCSC server, specify the -system option.

cscsvstop -user login-user-ID -pass login-password -csc HCSC-server-name -system

Furthermore, if you want to terminate only the specified logical server without terminating the HCSC server, specify the -logical option.

cscsvstop -user login-user-ID -pass login-password -csc HCSC-server-name -logical logical-server-name

Note that when terminating the HTTP Server within the logical server by specifying the -system or -logical option, there are two types of termination methods, standard termination and planned termination. For details about how to terminate the HTTP Server, see 5.3.37 Terminating the HTTP Server.

Using the cscutil command

Execute the cscutil command in the operating environment. Specify server in the -target option and stop in the -operation option.

For details about the cscutil command, see cscutil (Various operations) in the manual uCosminexus Service Platform Reference Guide.

The execution format of the cscutil command depends on whether or not a property definition file is used.

When a property definition file is not used

In the -props option, specify the HCSC server name, J2EE server name, and termination flag.

cscutil -user login-user-ID -pass login-password -mng manager-name -target server -operation stop -props "CSCSrvName= HCSC-server-name, J2EESrvName=J2EE-server-name, ForceFlag=termination-flag"

You can use the cscrepls command to check the Manager name, HCSC server name, and J2EE server name that are specified in the cscutil command. For details about the cscrepls command, see cscrepls (Displaying the repository information) in the manual uCosminexus Service Platform Reference Guide.

The termination flag specifies whether normal termination or forced termination is to be executed. In this flag, specify one of the following values:

• Normal termination: false

• Forced termination: true

When a property definition file is used

Specify the name of the property definition file name in the -propfile option. The property definition file must be created beforehand in the J2SE property file format.

cscutil -user login-user-ID -pass login-password -mng manager-name -target server -operation stop -propfile property-definition-file-name