stopServer command

The stopServer command reads the configuration file for the specified server process. This command sends a Java Management Extensions (JMX) command to the server telling it to shut down.

By default, the stopServer command does not return control to the command line until the server completes the shut down process. There is a -nowait option to return immediately, as well as other options to control the behavior of the stopServer command. For more information about where to run this command, see the Using command tools article.

Although the stopServer command returns control when the server completes shut down, it can return before the i5/OS process has terminated. Depending upon the amount of memory which the Java Virtual Machine must return to the memory pool, the process may take several seconds or minutes to completely end. You should not attempt to start the server again until the process has terminated. Use the WRKACTJOB SBS(subsystem) CL command to determine if the process has terminated completely. By default, subsystem is QWAS61.

Syntax

The command syntax is as follows:
stopServer <server> [options]
where server is the name of the configuration directory of the server you want to stop.

This argument is optional. If the default profile is being used, server defaults to server1. If the profile name is not default, then server defaults to the profile name.

Parameters

The following options are available for the stopServer command:

-nowait
Tells the stopServer command not to wait for successful shutdown of the server process.
-quiet
Suppresses the progress information that the stopServer command prints in normal mode.
-logfile <fileName>
Specifies the location of the log file to which trace information is written. By default, the log file is named stopServer.log and is created in the logs directory.
-profileName
Defines the profile of the Application Server process in a multi-profile installation. The -profileName option is not required for running in a single profile environment. The default for this option is the default profile.
-replacelog
Replaces the log file instead of appending to the current log.
-trace
Generates trace information into a file for debugging purposes. The trace output is written to the stopServer.log file which is located in the profile_root/logs/server directory.
-timeout <seconds>
Specifies the time to wait for server shutdown before timing out and returning an error.
-statusport <portNumber>
An optional parameter that allows an administrator to set the port number for server status callback. The tool opens this port and waits for status callback from the server just before the server has completely stopped. If the parameter is not set, an unused port is automatically allocated.
-port <portNumber>
Specifies the server Java Management Extensions (JMX) port to use explicitly, so that you can avoid reading the configuration files to obtain the information.
-username <name>
Specifies the user name for authentication if security is enabled in the server. Acts the same as the -user option.
-user <name>
Specifies the user name for authentication if security is enabled in the server. Acts the same as the -username option.
-password <password>
Specifies the password for authentication if security is enabled in the server.
Note: If you are running in a secure environment but have not provided a user ID and password, you will receive the following error message:
ADMN0022E: Access denied for the stop operation on Server MBean due 
to insufficient or empty credentials.
To solve this problem, provide the user ID and password information.
-help
Prints a usage statement.
-?
Prints a usage statement.

Usage scenario

The following examples demonstrate correct syntax:

stopServer server1

stopServer server1 -nowait 

stopServer server1 -trace (produces the stopserver.log file)

stopServer -profileName mytest (stops server mytest 
configured for profile mytest)



Related tasks
Using command line tools
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 8:21:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-express-iseries&topic=rxml_stopserver
File name: rxml_stopserver.html