uCosminexus Service Platform, Setup and Operation Guide

[Contents][Glossary][Index][Back][Next]

5.3.7 Starting Business Processes

This subsection describes the prerequisites for starting a business process and how to start it.

Organization of this subsection
(1) Prerequisites
(2) How to start a service adapter

(1) Prerequisites

Before you start a business process, the HCSC server must be in active status.

For details about how to check HCSC server status, see 5.3.15 Checking the HCSC server information.

(2) How to start a service adapter

This subsection describes how to start a business process.

(a) Using windows

To start a business process using windows in the operating environment:

  1. In the tree view, double-click the business process to be started.
    Information about the double-clicked business process is displayed in the editor area.
  2. 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 Cosminexus Service Platform Reference.
  3. Check the information displayed in the Operations page, and then click the Start button.
    A dialog box confirming startup of the business process is displayed.
  4. Check the information displayed in the dialog box and then click the OK button.
    Business process startup processing begins. Log information during startup processing is displayed in the console view.
    If the Cancel button is clicked, the system returns to the Operations page without executing startup processing.
    When business process startup processing is completed, a dialog box indicating the execution result is displayed.
  5. Check the dialog box indicating the execution result.
    If startup processing was successful:
    Click the OK button to return to the Operations page.
    On the Operations page, the business process status is set to active. Also, the Start button is disabled and the Stop button is enabled.
    If startup 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 start a business process, execute the csccompostart command or cscutil command in the operating environment.

Use the csccompostart and cscutil command in the following cases:

The following describes how to execute the above commands:

Using the csccompostart command
Execute the csccompostart command in the operating environment.
For details about the csccompostart command, see csccompostart (Starting HCSC components) in the manual Cosminexus Service Platform Reference.
The execution format of the csccompostart command is described below:
To start 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 are started in a batch (all the service adapters and user-defined receptions that are not running, are started at the same time).
 
csccompostart -user login-user-ID -pass login-password -cluster cluster-name -all
 
If you want to start only the business process without starting the service adapter and user-defined reception, specify the service ID of the business process.
 
csccompostart -user login-user-ID -pass login-password -cluster cluster-name -name service-ID-of-the-business-process
 
To start all the business processes deployed on the 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 started (all the service adapters and user-defined receptions that are not running, start at the same time).
 
csccompostart -user login-user-ID -pass login-password -csc HCSC-server-name -all
 
If you want to start only the business process without starting the service adapter and user-defined reception, specify the service ID of the business process.
 
csccompostart -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 start in the -operation option.
For details about the cscutil command, see cscutil (Various operations) in the manual Cosminexus Service Platform Reference.
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, J2EE server name, and type.
 
cscutil -user login-user-ID -pass login-password -mng manager-name -target compo -operation start -props "AdapterName=service-ID-of-the-business-process, CSCSrvName=HCSC-server-name, J2EESrvName=J2EE-server-name, ServiceKind=bp"
 
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 Cosminexus Service Platform Reference.
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 start -propfile property-definition-file-name