cjstopapp (stop J2EE application)

Format

For executing a normal termination

cjstopapp [server-name] [-nameserver provider-URL] 
     -name J2EE-application-name [-t timeout-time]

For manually executing a forced termination after a normal termination times out

cjstopapp [server-name] [-nameserver provider-URL] 
     -name J2EE-application-name -cancel

For automatically executing a forced termination after a normal termination times out

cjstopapp [server-name] [-nameserver provider-URL] 
     -name J2EE-application-name -t timeout-time -force

To Page Top

Function

This command stops a J2EE application and disables it from receiving 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 stopped.

-t timeout-time

Specifies the maximum amount of time (in seconds) from when the command is executed to wait for a response to be returned, as an integer in the range 0 to 2147483647. When 0 is specified, no response is returned to the client until stop processing is completed. If this argument is not specified, a time of 60 seconds is assumed.

-cancel

Specifies that the J2EE application is to be forcibly terminated manually after a normal termination times out.

-force

Specifies that the J2EE application is to be forcibly terminated automatically after a normal termination times out.

Forced stoppage of a J2EE application is not performed if the J2EE application stop processing is complete.^#

#

In the stop processing, the processing to stop the J2EE application is performed, and then the processing to undeploy the J2EE application is performed. After the processing to stop the J2EE application is complete, execution of server management commands is locked until the processing to undeploy the J2EE application is complete. Therefore, an update command is placed in a wait state until the currently running command ends. Run an update command after it is released from the wait state. You can confirm completion of the undeploy processing from the KDJE42142-I message on the J2EE server side. For details about stop processing, see the uCosminexus Application Server Operation, Monitoring, and Linkage Guide.

To Page Top

Input examples

cjstopapp 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

• 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 application-name -name); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver application-name -name provider-URL).

• If normal termination of the specified J2EE application that is performed by using this command is not completed within 60 seconds or within the time specified for the -t option, the command terminates due to an error.

• When a forced termination is executed and if the stop processing of the J2EE application does not terminate within the time specified in the -t option, the J2EE application is terminated forcibly within the time specified in the ejbserver.rmi.request.timeout key of the system property file for server management commands.

• 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 a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).

• If a timeout error occurs, use the cjlistapp (list applications) to check the J2EE application's status.

• To stop the J2EE application, see 5.5.7 Stopping a J2EE application in the uCosminexus Application Server Operation, Monitoring, and Linkage Guide.

To Page Top