5.3.36 Terminating the Business Process
This subsection describes the prerequisites for terminating the business process and how to terminate it.
- Organization of this subsection
(1) Prerequisites
To terminate the business process, the following conditions must be met:
-
The HCSC server is in active status.
For details about how to check HCSC server status, see 5.3.15 Checking the HCSC server information.
-
The business process is in active status.
For details about how to check business process status, see 5.3.18 Checking the business process information.
(2) Termination method
This subsection describes how to terminate the business process.
(a) Using windows
To terminate the business process using windows in the operating environment:
-
In the tree view, double-click the business process to be terminated.
Information about the double-clicked business process is displayed in the editor area.
-
In the editor area, choose the Operations page.
Information about operations of the business process you chose in step 1 is displayed.
For details about the Operations page for business processes, see 4.4 Operations Page in the manual uCosminexus Service Platform Reference Guide.
-
Check the information displayed in the Operations page, and then click the Stop button.
A dialog box confirming termination of the business process is displayed.
-
Check the information displayed in the dialog box and then click the OK button.
Business process 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 business process termination processing is completed, 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 business process 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 a business process, execute the csccompostop command or cscutil command in the operating environment.
Use the csccompostop and cscutil commands in the following cases:
-
csccompostop command
To terminate a business process in an operating environment where the corresponding repository exists.
-
cscutil command
To terminate a business process 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 csccompostop command
-
Execute the csccompostop command in the operating environment.
For details about the csccompostop command, see csccompostop (Stopping HCSC components) in the manual uCosminexus Service Platform Reference Guide.
The execution format of the csccompostop command is described below:
- To terminate the business processes deployed on all the HCSC servers in the cluster in a batch (for each cluster)
-
Specify the cluster-name and the -all option and execute the command.
The business processes deployed on all the HCSC servers in the cluster specified with the -cluster option terminate in a batch (all the service adapters and user-defined receptions that are not terminated are also terminated at the same time).
csccompostop -user login-user-ID -pass login-password -cluster cluster-name -all
If you want to terminate only the business process without terminating the service adapters and user-defined receptions, specify the service ID of the business process.
csccompostop -user login-user-ID -pass login-password -cluster cluster-name -name service-ID-of-the-business-process
- To terminate the business processes deployed on an HCSC server in a batch (for each HCSC server)
-
Specify the HCSC server name and the -all option and execute the command.
The business processes deployed on the HCSC server specified with the -csc option are terminated (all the service adapters and user-defined receptions that are not terminated are also terminated at the same time).
csccompostop -user login-user-ID -pass login-password -csc HCSC-server-name -all
If you want to terminate only the business process without terminating the service adapters and user-defined receptions, specify the service ID of the business process.
csccompostop -user login-user-ID -pass login-password -csc HCSC-server-name -name service-ID-of-the-business-process
- Using the cscutil command
-
Execute the cscutil command in the operating environment. Specify compo 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 business process's service ID, HCSC server name, and J2EE server name.
cscutil -user login-user-ID -pass login-password -mng manager-name -target compo -operation stop -props "AdapterName=service-ID-of-the-business-process, CSCSrvName=HCSC-server-name, J2EESrvName=J2EE-server-name"
You can use the cscrepls command to check the Manager name, business process's service ID, 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.
- 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 compo -operation stop -propfile property-definition-file-name