Stop an application server with the stopServer script

The stopServer script stops the specified server. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.

Authority

To run this script, your user profile must have *ALLOBJ authority. For information on setting explicit authorities for a user profile that does not have *ALLOBJ authority, see Set explicit authorities for the startServer and stopServer scripts.

Usage

To stop an instance with the stopServer script, follow these steps:

1. On the CL command line, run the STRQSH (Start Qshell) command.

2. Run the cd command to change to the directory that contains the script:

   cd /QIBM/ProdData/WebASE/ASE5/bin

3. Run the stopServer script:

   stopServer -instance instance server

   where instance is the name of the instance you want to stop and server is the name of the application server that you want to stop.

Syntax

The syntax of the stopServer script is:

stopServer server -instance instance [ -nowait ] [ -quiet ]
 [ -logfile filename ] [ -replacelog ] [ -trace ] [ -timeout seconds ]
 [ -statusport statusportnumber ] [ -port portnumber ]
 [ -username username ] [ -password password ] [ -conntype SOAP | RMI ]
 [ -help | -? ]

Parameters

The parameters of the stopServer script are:

• server
  This is a required parameter. The value server specifies the name of the server that you want to stop. This value is case sensitive.

• -instance
  This is a required parameter. The value instance specifies the name of the instance that contains the server that you want to stop.

• -nowait
  This is an optional parameter. If you specify this parameter, the script returns control to the user without waiting for the server to stop successfully. The default is to wait for the server to stop successfully.

• -quiet
  This is an optional parameter. If you specify this parameter, the script does not display informational messages. The default is to display informational messages while the script runs.

• -logfile
  This is an optional parameter. The value filename specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebASE/ASE5/instance/logs/server/stopServer.log where instance is the name of the instance that contains the server that you want to stop, and server is the name of the server that you want to stop.

• -replacelog
  This is an optional parameter. If you specify this parameter, the script replaces the log file if it exists. By default the script appends to the log file if it exists.

• -trace
  This is an optional parameter. If you specify this parameter, the script outputs additional trace information to the log file for the script. You should only specify this parameter if errors occur when you try to stop a server. The default is to not log additional trace information.

• -timeout
  This is an optional parameter. The value seconds specifies the amount of time in seconds to wait for the server to stop before returning control to the caller. The default is to wait until the server has stopped successfully.

• -statusport
  This is an optional parameter. The value statusportnumber specifies the port on which to listen for the status of the server while it is stopping. The default is to use the next available port.

• -port
  This is an optional parameter. The value portnumber specifies the SOAP or RMI port for the server. If you specify this parameter, the stopServer script sends the stop command directly to server. If you specify the RMI port value for this parameter, you must also specify the -conntype parameter. By default, the script reads the configuration files to obtain the information that is necessary to stop the server.

• -conntype
  This is an optional parameter. If you specify the -port parameter, the -conntype parameter specifies the connector type to use. Valid values are SOAP or RMI. The default value is SOAP.

• -username
  This parameter is required if security is enabled for the server. The value username specifies the user name for authentication.

• -password
  This parameter is required if security is enabled for the server. The value password specifies the password for authentication.

• -help or -?
  This optional paramter prints the usage statement for the script.

Example

stopServer myserver -instance myserver -port 10380

This example uses port 10380 to stop the myserver application server in the myserver instance.