Start an application server with the startServer script

The startServer script reads the configuration file for the specified server process and starts the 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 start an application server with the startServer script, follow these steps:

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

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

cd /QIBM/ProdData/WebASE51/ASE/bin

Run the startServer script:

startServer -instance instance server

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

When the application server is running, the script displays this message:

ASE6123: Application server started.                                      
 Cause . . . . . :   Application server instance in ASE5 instance instance has    started and is ready to accept connections on admin port admin_port

where instance is the name of your instance and admin_port is the port number for the WebSphere administrative console.

If you specify the -nowait parameter, the script does not display this message. You must verify that the application server has started before you continue.

Syntax

The syntax of the startServer script is:

startServer server -instance instance
 [ -nowait ] [ -timeout seconds ] [ -trace ] [ -help | -? ]

where server is the name of the configuration directory of the server you want to start.

Parameters

The parameters of the startServer script are:

server
This required parameter specifies the name of the server that you want to start. If server is not specified, the server name defaults to the value specified for the -instance parameter. 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 start.

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

-timeout
This is an optional parameter. The value seconds specifies the amount of time in seconds to wait for successful initialization of the server. The script returns control to the user at the end of the timeout value. The default is to wait until the server initialization is complete.

-trace
This is an optional parameter. If you specify this parameter, the trace function is turned on. The trace output is written to the JOBNAME.JOBUSER.JOBNUMBER file in the /QIBM/UserData/WebASE51/ASE/service/trace directory, where JOBNAME, JOBUSER, and JOBNUMBER are taken from the application server job. The job name is output when the job is submitted by the script.

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

Examples

startServer -instance myinst

This example starts the myinst application server in the myinst instance.

startServer devinst -instance devinst -nowait

This example starts the devinst application server in the devinst instance and returns control immediately to the user.