cjstartapp (start J2EE application)
Format
cjstartapp [server-name] [-nameserver provider-URL]
-name J2EE-application-name [-jspc]
Function
This command starts a J2EE application and enables it to receive requests from clients.
Arguments
- server-name
- Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.
- -nameserver provider-URL
- Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:
protocol-name: : host-name: port-number
- For details on the specification items, see 2.1(2) Provider URL.
- -name J2EE-application-name
- Specifies the name of the J2EE application that is to be started.
- -jspc
- Specifies that the command is to execute JSP precompilation. You specify this argument when an existing Web application is the application to be started after JSP precompilation has executed. Application startup is executed even if an error occurs during JSP precompilation.
Input examples
cjstartapp MyServer -name App1
Return values
- 0:
- The command terminated normally.
- 1:
- The command terminated abnormally.
- 2:
- The command could not be executed because of an exclusion error.
- 3:
- A timeout occurred.
- 9:
- The command could not be executed because there are no administrator privileges (in Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista).
Notes
- If the specified J2EE application does not exist, this command terminates with an error.
- When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify provider-URL -nameserver); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver J2EE-application-name -name provider-URL).
- When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).
- Note the following when you specify the -jspc option:
- If you specify the -jspc option, all the JSP files included in the Web application are compiled, and an error might occur since JSP files that are not required to be compiled are also compiled. The cjstartapp command continues processing, even if a compilation error occurs in the JSP precompilation during application startup.
- For the archive format applications, if application startup fails, the application stops and the JSP compilation result is deleted. Therefore, first ensure that the application can be started.
- If the JSP pre-compilation used during application startup is executed, the communication timeout might occur for the cjstartapp command depending on the number of JSPs included in the application. If the communication timeout occurs in the cjstartapp command, reference the J2EE server message log and confirm that the application is started normally. Also, check, and if necessary, revise the communication timeout value defined for the server management commands.