startServer command

The startServer command reads the configuration file for the specified server process and starts that server process.

The server process can be an application server or an administrative agent.

Note: This topic references one or more of the application server log files. As a recommended alternative, you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM® i systems. You can also use HPEL in conjunction with your native z/OS® logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.

You do not have to use a user name and password with the startServer command because this command launches a server process but does not invoke an MBean method.

Avoid trouble Avoid trouble: You can use the administrative console to change the Java virtual machine Classpath setting or the environment entries settings for a server. However, before making these changes you should understand the following consequences of making these changes: gotcha

For more information about where to run this command, see the Using command line tool topic.

Syntax

The command syntax is one of the following:
startServer server_name [options]

where server_name is the name of the application server that you want to start.

[IBM i] This argument is optional. If this argument is not specified, a server is assigned based on your profile name. If you use the profile named default, the <server> argument is set to server1. If the profile name is not default, the <server> argument is set to the profile name.

startServer <adminagent_name>

whereadminagent_name is the name of the administrative agent that you want to start.

Parameters

The following options are available for the startServer command:

-?
Prints a usage statement.
[IBM i] -curlib <product_library>
Specifies the current library to use for the underlying Submit Job (SBMJOB) CL command.
[IBM i] -cpyenvvar
Tells the startServer command to set the environment variables that are currently defined for the server process. The default is to not set the currently defined environment variables.
-help
Prints a usage statement.
[IBM i] -inllibl <library_list>
Specifies the initial library list to use for the underlying Submit Job (SBMJOB) CL command.
[IBM i] -inlaspgrp <ASP_group>
Specifies the initial ASP group for the underlying Submit Job (SBMJOB) CL command.
[IBM i] -jobd <product_library/job_description>
Specifies the job description for the underlying Submit Job (SBMJOB) CL command.
[IBM i] -jobq <product_library/job_queue>
Specifies the job queue for the underlying Submit Job (SBMJOB) CL command.
[IBM i] -nowait
Tells the startServer command not to wait for successful initialization of the launched server process.
[IBM i] -outq <product_library/output_queue>
Specifies the output queue for the underlying Submit Job (SBMJOB) CL command.
-profileName
Defines the profile of the 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.
-recovery
Specifies that the server will start in recovery mode, perform a transactional recovery, and shut down. The server will not accept any new transactions while it is in recovery mode. When you start the server again, resources that were unavailable due to questionable transactions will be available.

Use this option if a server fails and you do not want to accept new transactions during the recovery process.

transition: If you are migrating from a previous version of the product, make sure that the ENV parameter included on the JCL procedure statement for the controller includes either the REC=N or the REC=Y element. If the ENV parameter does not include either the REC=N or the REC=Y element, the server will not restart in recovery mode even if you specify the -recovery option.
//BBO6ACR  PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
[IBM i] When you invoke the startServer command with the -recovery parameter and the recovery process is unsuccessful, the following error message occurs in the SystemErr.log and SystemOut.log files:
CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.
The message does not indicate that the recovery process was unsuccessful. If you use the -recovery parameter, check the SystemErr.log and SystemOut.log files for the server that you are starting to determine if the recovery process was successful.
[IBM i] -sbs <product_library/subsystem_description>
Specifies the subsystem to use for the underlying Submit Job (SBMJOB) CL command.
-trace
[IBM i] Enables tracing of the native process code that starts the server. The trace output is written to the was_jobname-jobuser-jobnum.log file which is located in the profile_root/logs directory.
-timeout <seconds>
Specifies the waiting time before server initialization times out and returns an error.
[IBM i] -usejobd
Specifies to use the job description from the Submit Job (SBMJOB) process for the server when switching to the Run-As user ID.
Note: This command does not affect the USER field of the current job description.

Usage scenario

The following examples demonstrate correct syntax. The information within the parentheses is a description of the output that is created if you issue the preceding command.

[IBM i]
startServer server1 (starts the server1 server for the default profile)

startServer server1 -trace (starts the server1 server for
the default profile and produces trace files under the
profile_root/logs directory)

startServer -profileName mytest (starts server mytest 
configured under profile mytest)

startServer AdminAgent01
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)
Reference topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 10:32 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=rxml_startserver
File name: rxml_startserver.html