cmx_stop_resource (Stop a resource) (For compatibility)
Format
- To stop by specifying a resource adapter
cmx_stop_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname resource-adapter-display-name
- To stop by specifying a JavaBeans resource
cmx_stop_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname JavaBeans-resource-display-name
- To stop without specifying a resource adapter or JavaBeans resource
cmx_stop_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name]
Function
This command stops a resource adapter or a JavaBeans resource. The resource adapter or the JavaBeans resource to be stopped differs when the resource adapter or the JavaBeans resource is specified in the command and when the resource adapter or the JavaBeans resource is not specified in the command.
- When the resource adapter or the JavaBeans resource is specified
The specified resource adapter or the JavaBeans resource stops for all the service units included in the Web system.
If a service unit is specified, the specified resource adapter or the JavaBeans resource stops for the specified service unit.
- When the resource adapter or the JavaBeans resource is not specified
All the resource adapters or the JavaBeans resources associated with a Web system stop for all the service units included in the Web system.
If a service unit is specified, all the resource adapters or the JavaBeans resources associated with a Web system stop for the specified service unit.
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_resource command by omitting the -s option, an error occurs.
- -unit service-unit-name
- Specifies the service unit name.
- -resname resource-adapter-display-name-or-JavaBeans-resource-display-name
- Specifies the display name of the resource adapter or the JavaBeans resource. You use the display name output to the message issued after the cmx_register_resource command is executed.
Input examples
cmx_stop_resource sample-system -unit unit1 -resname App1
Return values
- 0:
- The command is terminated normally.
- 1:
- The command is terminated with a warning.
- 64:
- The command is terminated abnormally.
Notes
- If resource adapters that use the cluster connection pool functionality are included in the stop target, make sure that you specify the resource adapters in the -resname option and stop the resource adapters one by one. In this case, first stop root resource adapters, and then stop member resource adapters.
Also, if the resource adapters that use the cluster connection pool functionality and the resource adapters that do not use the functionality are included in the stop target, first stop all the resource adapters that use the cluster connection pool functionality, and then input the cmx_stop_resource command without specifying the -resname option to stop the other resource adapters.
- If the service unit for memory session failover is specified for processing, an error occurs.
- This command is used for compatibility with earlier versions. For the commands related to resource operations, we recommend that you use the server management commands in the version 08-00 and later versions.