cmx_undeploy_resource (Undeploy a resource) (For compatibility)
Format
- To undeploy by specifying a resource adapter
cmx_undeploy_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname resource-adapter-display-name
- To undeploy by specifying a JavaBeans resource
cmx_undeploy_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname JavaBeans-resource-display-name
- To undeploy without specifying a resource adapter or JavaBeans resource
cmx_undeploy_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name]
Function
This command undeploys a resource adapter or JavaBeans resource from a service unit. The method used for undeploying a resource adapter or a JavaBeans resource 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 will be undeployed from all the service units included in the Web system.
If the service unit is specified, the specified resource adapter or the JavaBeans resource will be undeployed from 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 will be undeployed from all the service units included in the Web system.
If the service unit is specified, all the resource adapters or the JavaBeans resources associated with a Web system will be undeployed from 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_undeploy_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_undeploy_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 the service unit for memory session failover is specified for processing, an error occurs.
- This command is used for compatibility with the 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.