cjstartapp (start J2EE application)

Format

cjstartapp [server-name] [-nameserver provider-URL] 
      -name J2EE-application-name [-jspc]

To Page Top

Function

This command starts a J2EE application and enables it to receive requests from clients.

To Page Top

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.

To Page Top

Input examples

cjstartapp MyServer -name App1

To Page Top

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).

To Page Top

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.

To Page Top