cmx_stop_target (Stop a Web system or a service unit)

Format

Function

Arguments

-s web-system-name
Specifies the Web system name.
If you omit this option, the value set in the cmx.websystem.name key of the .cmxrc file or the cmxclient.properties file will be used. Note that if the cmx.websystem.name key is not specified in the .cmxrc file and the cmxclient.properties file and if you execute the cmx_stop_target command by omitting the -s option, an error occurs.
-unit service-unit-name
Specifies the service unit name.
-mode { ALL | HOLD }
Specifies the stop mode.
  • ALL
    Downgrades the operating status, ready status, and the blockade status to the stopped status.
  • HOLD
    Downgrades the operating status and the ready status to the blockade status.
    You cannot upgrade a service unit, from the stopped status to the blockade status.
-ns
Specify this option to stop a system containing the logical server that is not associated with the Web system.
-normal
You specify this option, for not terminating the Web server in a planned manner. If you execute the cmx_stop_target command without specifying this option, the Web server will terminate in a planned manner.

Input examples

cmx_stop_target -s sample-system -unit unit1 -mode ALL

Return values

0:
The command is terminated normally.
1:
The command is terminated with a warning.
64:
The command is terminated abnormally.

Notes

A process is continued even if logical server fails to stop. If logical Web server fails to stop, receiving of requests is continued. In this case, -mode option is specified at the time of batch stop and a target system is first changed to blockade state and then changed to stop state.