cmx_start_application (Start a J2EE application) (For compatibility)
Format
- To start by specifying a J2EE application
cmx_start_application [Common-arguments] [-s web-system-name] [-unit service-unit-name] -appname application-display-name
- To start without specifying a J2EE application
cmx_start_application [Common-arguments] [-s web-system-name] [-unit service-unit-name]
Function
This command starts J2EE applications. The J2EE application to be started differs when the J2EE application is specified in the command and when the J2EE application is not specified in the command.
- When the J2EE application is specified
The specified J2EE application starts on all the service units included in the Web system.
If the service unit is specified, the specified J2EE application starts on the specified service unit.
- When the J2EE application is not specified
All the J2EE applications (archive format and exploded archive format) associated with the Web system start on all the service units included in the Web system.
If the service unit is specified, all the J2EE applications 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_application command by omitting the -s option, an error occurs.
- -unit service-unit-name
- Specifies the service unit name.
- -appname application-display-name
- Specifies the display name of the J2EE application. You use the display name that is output to the message issued after the cmx_register_application command is executed.
Input examples
cmx_start_application -s sample-system -unit unit1 -appname 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 the processing, an error occurs.
- This command is used for compatibility with the earlier versions. For the commands related to application operations, we recommend that you use the server management commands in the version 08-00 and later versions.