uCosminexus Service Platform, Basic Development Guide

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

9.3 Starting debugging of business processes

The following describes the procedure for starting the business process.

  1. Start the test environment.
    For details about how to start the test environment, see 2.4.3(1) Starting and stopping the test environment.
  2. Start standard reception.
    This step is not required if standard reception is not used in the business process.
    For details about how to start standard reception, see Cosminexus Service Platform System Setup and Operation Guide.
  3. Any of the following methods displays the Debug configuration dialog box.
    • In the Eclipse toolbar, choose Debug ([Figure]), Configure debug.
    • In the List of service definitions of tree view, right click the business process for debugging and choose Configure debug.
    • Right click the target project in the package explorer and choose Debug and Configure debug.
    • In the Eclipse menu, choose Execute and Configure debug.
  4. In the menu of the Debug configuration dialog box, right click HCSC-BP and choose New.
  5. Enter the debug name in Name.
  6. In the Debug target drop down list of the Business process setting tab, choose the business process for debugging.
  7. Choose the Debug setting tab and specify the required information.
    For contents displayed or specified in the Debug setting tab, see Cosminexus Service Platform Reference.
  8. Click Debug.
    Console view displays the expiry of the debug start process. If the business process, user-defined reception and service adapter are being edited, a dialog box appears for confirming whether to save the definitions being edited.
    The business process editor appears. For details about the business process editor, see Cosminexus Service Platform Reference.
    Once Eclipse starts, the Authenticate account dialog box appears when debugging of the business process first starts. Enter the user ID and password to start the start process of debugging the business process.
  9. Click OK.
    Debugging of the business process starts.
    Once debugging of the business process starts, a shortcut is created for the debug configuration in the Debug menu of Eclipse. Thereafter, you can choose the shortcut to skip operations of the steps from 3-8 and start debugging.
    Note
    • Configure the development environment, operation environment and execution environment in the same machine. Operations cannot be guaranteed for multiple machine configurations.
    • The HCSC server must be set up. Note that setup must be executed by a single HCSC server configuration. Even if HCSC easy setup is used, single HCSC server configuration must be set up.
    • Start the HCSC server and database in advance.
    • The following errors might occur when debugging of the business process starts.
      The repository configuration forms in the development environment and operation environment (combination of database and Cosminexus RM) do not match.
      The service deployed in the repository of the operation environment has changed or is deleted from the development environment.
      SOAP modes in the repository of the development environment and operation environment do not match.
      If an error occurs, stop all defined HCSC components, delete them from the HCSC server and restart debugging of the business process.
    • If an error occurs while debugging of the business process is starting, interrupt the process and exit. Processes that exited before the error occurred do not return to status before starting. In such cases, remove the cause of the error and restart.
    • If the business process and service adapter change after debugging of the business process starts, the functions of debug might not operate normally. If the business process and service adapter change while debugging, end the debugging of the business process once and then restart debugging.
    • Start debugging the business process in a single machine. Operations cannot be guaranteed for debugging started between multiple machines.
    • Debugging of the business process can be started or ended only once. If multiple debug configurations are selected in Debug view, do not start or end debug.
    • Debug starts only for the business process selected in Debug target of the Debug configuration dialog box. To debug simultaneously multiple business processes such as other business processes invoked from the business process, start debugging each business process.
    • If debugging fails to start, the service cannot be started. Debugging of the business process might not start till the HCSC component stops. If debugging fails to start, execute in the order of the csccompostop -all command and the csccompoundeploy -all command, stop the HCSC component and undeploy. Then restart debugging the business process. You cannot stop the HCSC component by the methods in 7.6 Batch execution of processes for stopping HCSC components and deleting them from the HCSC server.
      For details about the csccompostop command and csccompoundeploy command, see Cosminexus Service Platform Reference.
    • The same business process cannot be duplicated and started.
    • You can start debugging of only the business process having latest version. You cannot execute debugging of a business process having any other version.
    • If you execute debugging of the business process, the following message is output in the message log multiple times.
      Message output when you try to read a value of variable, which is not initialized (KDEC20052-E)
      Message output when you try to read a value of correlation set, which is not initialized (KDEC20065-E)
    • Do not execute following functions after starting the debugging of business process.
      Closing HCSCTE project
      Deleting HCSCTE project
      Changing repository directory
      Initializing repository
      Importing repository
      Importing services
      Exporting services
    Reference note
    While starting debugging of the business process, the process to deploy and start HCSC components in the HCSC server is executed in a batch. At this stage, the business process, service adapter and user defined reception are deployed and defined as follows:
    • Business process
      The business process selected in the Debug configuration dialog box is repackaged and then deployed and defined.
      If the business process seen from the business process selected in the Debug configuration dialog box is already deployed and defined (public), it is not redeployed and defined when the debugging of the business process starts. In other cases, it is repackaged and then deployed and defined.
    • Service adapter
      If it is already packaged and if it is already deployed and defined (public), it is not repackaged and then deployed and defined when the debugging of the business process starts.
    • User-defined reception
      The user-defined reception of the business process selected in the Debug configuration dialog box is redeployed and defined.
      If the user-defined reception of the business process seen from the business process selected in the Debug configuration dialog box is already deployed and defined (public), it is not redeployed and defined when the debugging of the business process starts. In other cases, it is redeployed and defined.