5.3.33 Terminating the Standard Reception
The supported methods for terminating standard receptions are normal termination, planned termination, and forced termination.
- Normal termination
-
- For synchronous acceptance
-
The system processes the current execution request and then terminates the standard reception.
- For asynchronous acceptance
-
The system places an execution request from the service requester in unaccepted status, processes the current execution request, and then terminates the standard reception. Accepted execution requests remain unprocessed in the queue.
When the standard reception is restarted after normal termination, processing begins with the execution requests remaining in the queue.
If HCSC server setup is cancelled after normal termination, the execution requests remaining in the queue are discarded.
- Planned termination
-
This termination method is used to cancel HCSC server setup after terminating the standard reception. When planned termination is executed, the standard reception is terminated as follows:
- For synchronous acceptance
-
The system processes the current execution request and then terminates the standard reception.
- For asynchronous acceptance
-
The system places an execution request from the service requester in unaccepted status, processes all the execution requests remaining in the queue, and then terminates the standard reception.
- Forced termination
-
Forced termination can be achieved by commands only. This termination method can forcibly terminate the standard reception even when another command is executing or when the standard reception termination error has occurred.
This subsection describes the prerequisites for terminating the standard reception and how to terminate it.
- Organization of this subsection
(1) Prerequisites
To terminate the standard reception, the following conditions must be met:
-
The HCSC server is running.
-
The standard reception is in active status.
For details about how to check the status of the HCSC server and standard reception, see 5.3.15 Checking the HCSC server information.
(2) Termination method
This subsection describes how to terminate the standard reception.
- Important note
-
If termination of the standard reception fails, eliminate the cause of the error and then forcibly terminate the standard reception. Once the standard reception is in inactive status, start it again to restart operations. For details about how to start the standard reception, see 5.3.9 Starting standard receptions.
(a) Using windows
To terminate the standard reception using windows in the operating environment:
-
In the tree view, double-click the HCSC server on which you wish to terminate the standard reception.
Information about the double-clicked HCSC server is displayed in the editor area.
-
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.
-
Check the information displayed in the Operations page, and under Request reception, click the Normal Stop or Planned Stop button.
A dialog box confirming termination of the standard reception is displayed.
-
Check the information displayed in the dialog box and then click the OK button.
Standard reception 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 standard reception termination processing is finished, a dialog box indicating the execution result is displayed.
-
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, the standard reception status is set to inactive. Also, the Normal Stop and Planned Stop buttons are 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 standard reception, execute the cscrcptnstop command or cscutil command in the operating environment.
Use the cscrcptnstop command and cscutil command in the following cases:
-
cscrcptnstop command
To terminate the standard reception in the operating environment where the corresponding repository exists.
-
cscutil command
To terminate the standard reception in an environment (for example, execution environment operating directly 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 cscrcptnstop command
-
Execute the cscrcptnstop command in the operating environment.
For details about the cscrcptnstop command, see cscrcptnstop (Stopping standard receptions and user-defined receptions) in the manual uCosminexus Service Platform Reference Guide.
The execution format of the cscrcptnstop command is explained below:
- To terminate the standard receptions of all the HCSC servers in the cluster, in a batch (for each cluster)
-
Specify the cluster name and execute the command.
The standard receptions of all the HCSC servers in the cluster specified with the -cluster option are terminated in a batch (all the user-defined receptions that are not terminated are also terminated at the same time).
cscrcptnstop -user login-user-ID -pass login-password -cluster cluster-name
If you want to terminate only the standard reception without terminating the user-defined reception, specify the -standard option.
cscrcptnstop -user login-user-ID -pass login-password -cluster cluster-name -standard
- To terminate the standard reception for the HCSC server in a batch (For each HCSC server)
-
Specify the HCSC server name and execute the command.
The standard reception for the HCSC server specified with the -csc option is terminated (all the user-defined receptions that are not terminated are also terminated at the same time).
cscrcptnstop -user login-user-ID -pass login-password -csc HCSC-server-name
If you want to terminate only the standard reception without terminating the user-defined reception, specify the -standard option.
cscrcptnstop -user login-user-ID -pass login-password -csc HCSC-server-name -standard
- Using the cscutil command
-
Execute the cscutil command in the operating environment. Specify request_service 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 request_service -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, planned termination, or forced termination is to be executed. In this flag, specify one of the following values:
-
Normal termination: NORMAL_OPTION
-
Planned termination: WAIT_OPTION
-
Forced termination: FORCE_OPTION
-
- 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 request_service -operation stop -propfile property-definition-file-name