cmx_start_resource (Start a resource) (For compatibility)
Format
- To start by specifying a resource adapter
cmx_start_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname resource-adapter-display-name
- To start by specifying a JavaBeans resource
cmx_start_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name] -resname JavaBeans-resource-display-name
- To start without specifying a resource adapter or a JavaBeans resource
cmx_start_resource [Common-arguments] [-s web-system-name] [-unit service-unit-name]
Function
This command starts a resource adapter or a JavaBeans resource. The resource adapter or the JavaBeans resource to be started 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 starts on all the service units included in the Web system.
If a service unit is specified, the specified resource adapter or the JavaBeans resource starts on 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 the Web system start on 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 the Web system start on 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_start_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_start_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 start target, make sure that you specify the resource adapters in the -resname option and start the resource adapters one by one. In this case, first you start member resource adapters, and then start root resource adapter.
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 start target, first you start all the resource adapters that use the cluster connection pool functionality, and then input the cmx_start_resource command without specifying the -resname option to start the other resource adapters.
- To start a resource adapter used for connecting to a database queue, make sure that you specify the resource adapter in the -resname option, and then start the resource adapter as follows:
- DB Connector for Cosminexus RM
- Cosminexus RM
- 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.