csccompostop (Stopping HCSC components)

Format

csccompostop [-h]
-user login-user-ID
-pass login-password
{-csc HCSC-server-name|-cluster cluster-name}
{-name service-ID|reception-ID|-all
|-namelist file-name-specifying-HCSC-components}
[-nogc]

Function

Stops HCSC components.

By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.

For details on how to use this command, see the following locations in the Service Platform System Setup and Operation Guide according to the purpose of use:

Arguments

-h

Displays the usage of commands. When you specify this option, all other options are ignored even if specified.

-user login-user-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))

Specifies the user ID that is used to log in to HCSC-Manager.

-pass login-password ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))

Specifies the password that is used to log in to HCSC-Manager.

-csc HCSC-server-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))

Specifies the HCSC server name of the HCSC components to be stopped.

-cluster cluster-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))

Specifies the name of the cluster where the HCSC components will be stopped in a batch. An error occurs if you specify the -cluster option when the cluster type is HA.

-name service-ID|reception-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))

Specifies the service ID or reception ID of the HCSC components to be stopped. When you specify this option along with the -cluster option, all the HCSC components with the same service ID within the cluster will stop.

-all

Stops all the running HCSC components within the specified range. When you specify this option along with the -csc option, all the running HCSC components within that HCSC server will start. When you specify this option along with the -cluster option, all the running HCSC components within that cluster will stop.

The following table lists the order in which the HCSC components are stopped when you specify this option. If an error occurs during processing, the stop processing will end even if all the HCSC components are not stopped.

Stopping orderTypes of HCSC componentsStopping order within HCSC components
1User-defined receptionAscending order of business process names and reception IDs
2Business processAscending order of business process names
3Service adapterAscending order of service IDs

-namelist file-name-specifying-HCSC-components ~ ((1 to 200 bytes))

Uses the HCSC component-specification file to specify the HCSC components to be stopped. Specify this file with an absolute or relative path. If the file does not exist, the command ends abnormally. For details on the HCSC component-specification file, see HCSC component-specification file.

Note that the HCSC components are stopped in the same order as that described for the -all option.

-nogc

Stops the components without generating Full GC. However, the specification of this option does not control Full GC generated automatically by JavaVM.

Examples of input

(1) To stop BP1 existing on the HCSC server HCSC

csccompostop -user admin -pass admin -csc HCSC -name BP1

(2) To stop all the HCSC components existing on the HCSC server HCSC in a batch

csccompostop -user admin -pass admin -csc HCSC -all

(3) To stop BP1 on each HCSC server in the cluster Cluster in a batch

csccompostop -user admin -pass admin -cluster Cluster -name BP1

(4) To stop all the HCSC components existing in the cluster Cluster in a batch

csccompostop -user admin -pass admin -cluster Cluster -all

(5) To stop BP1 existing on the HCSC server CSCSrv1 in a batch and without generating Full GC

csccompostop -user admin -pass admin -csc CSCSrv1 -name BP1 -nogc

(6) To stop the HCSC components specified in the HCSC component-specification file hcsccomponent.txt, from among the HCSC components on the HCSC server CSCSrv1, in a batch

csccompostop -user admin -pass admin -csc CSCSrv1 -namelist hcsccomponent.txt

Return values

Return valueMeaning
0The command terminated normally.
1The command terminated abnormally.
2A communication timeout occurred.
3An exclusion error occurred.
9An error occurred when checking the execution permission.

Notes