5.3.35 Terminating the Service Adapter

(a) Using windows

To terminate the service adapter using windows in the operating environment:

1. In the tree view, double-click the service adapter to be terminated.

   Information about the double-clicked service adapter is displayed on the Operations page in the editor area.

   For details about the Operations page for service adapters, see 4.4 Operations Page in the manual uCosminexus Service Platform Reference Guide.

2. Check the information displayed in the Operations page, and then click the Stop button.

   A dialog box confirming termination of the service adapter is displayed.

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

   Service adapter 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 service adapter termination processing is completed, a dialog box indicating the execution result is displayed.

4. 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 service adapter 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 service adapter, 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 service adapter in the operating environment where the corresponding repository exists.

• cscutil command

  To terminate a service adapter 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 service adapters 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 service adapters deployed on all the HCSC servers in the cluster specified with the -cluster option terminate in a batch (all the business processes and user-defined receptions that are not terminated already 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 service adaptor without terminating the business processes and user-defined receptions, specify the service ID of the service adapter.

csccompostop -user login-user-ID -pass login-password -cluster cluster-name -name service-ID-of-the-service-adapter

To terminate the service adapters 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 service adapters deployed on the HCSC server specified with the -csc option are terminated (all the business processes and user-defined receptions that are not terminated already 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 service adapter without terminating the business processes and user-defined receptions, specify the service ID of the service adapter.

csccompostop -user login-user-ID -pass login-password -csc HCSC-server-name -name service-ID-of-the-service-adapter

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 service adapter'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-service-adapter, CSCSrvName=HCSC-server-name, J2EESrvName=J2EE-server-name"

You can use the cscrepls command to check the Manager name, service adapter'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