Process definition settings

Use this page to view or change settings for a process definition. For WebSphere Application Server, this page provides command-line information for starting or initializing a process. For WebSphere Application Server for z/OS, this page provides command-line information for starting, initializing, or stopping a process.

To view this administrative console page, click Servers > Application Servers > server_name > Process Definition >process type.

Each of the commands that follows can be used for the control process. The servant process uses only the Start command and Start Command Args. Specify the commands for the control process on one process definition panel and the commands for the servant process on another process definition panel. Do not put the commands for the two different processes on the same panel.

Configuration tab

Start Command (startCommand)  
Specifies the platform-specific command to launch the server process.
Control process
Data type String
Format START control JCL procedure name
Example START BBO5ACR
Servant process

For the servant process, the value on the start command specifies the procedure name that Workload Manager (WLM) uses to start the servant process. WLM only uses this value if the WLM Dynamic Application Environment feature is installed.

Data type String
Format servant JCL procedure name
Example BBO5ASR
Start Command Args (startCommandArgs)  
Specifies any additional arguments required by the start command.
Control process
Data type String
Format JOBNAME=server short name,ENV=cell short name.node short name.server short name
Example JOBNAME=BBOS001,ENV=SY1.SY1.BBOS001
Servant process
Data type String
Format JOBNAME=server short nameS,ENV=cell short name.node short name.server short name
Example JOBNAME=BBOS001S,ENV=SY1.SY1.BBOS001

[Version 5.0.2]Note: By default, the server short name (JOBNAME) contains 7 characters, but you can lengthen the short name to 8 characters. For more information, see Application server settings.

Stop Command (stopCommand)  
Specifies the platform-specific command to stop the server process

Specify two commands in the field, one for the Stop command and one for the Immediate Stop (CANCEL) command.

Data type String
Format STOP server short name;CANCEL server short name
Example STOP BBOS001;CANCEL BBOS001

Stop Command Args (stopCommandArgs)  
Specifies any additional arguments required by the stop command.

Specify arguments for the Stop command and the Immediate Stop (CANCEL) command.

Data type String
Format stop command arg string;immediate stop command arg string
Example ;ARMRESTART

Note: In this example, Stop has no arguments. Immediate Stop has the argument ARMRESTART. A semicolon precedes ARMRESTART.

Terminate Command (terminateCommand)  
Specifies the command to terminate the server process.

Data type String
Format FORCE server short name
Example FORCE BBOS001

Terminate Command Args (terminateCommandArgs)  
Specifies any additional arguments required by the terminate command.

The default is an empty string.

Data type String
Format terminate command arg string
Example ARMRESTART

Working Directory
For distributed platforms, specifies the file system directory that the process uses as its current working directory.

Note: z/OS users should not use the Working Directory setting on the administrative console. On z/OS, the working directory is always the UNIX System Services directory that is defined via the OMVS setting of the RACF user profile for the user that starts the servant. For z/OS, this cannot be changed via the administrative console. Therefore, to provide compatibility between the applications on a z/OS system and a distributed system, set the UNIX System Services directory to the same value that was supplied for the Working Directory option on the distributed system.

The process uses this directory to determine the locations of input and output files with relative path names.

Data type String
Executable Target Type

Specifies whether a Java classname or the name of an executable JAR file is used as the executable target of this Java process.

Executable Target

Specifies the Java class or JAR file to use as the main entry point for the Java server process. Make sure that you select a target that matches the type selected in the Executable Target Type field.


Related concepts
Process definition
Related tasks
Defining application server processes
Related reference
Administrative console buttons
Administrative console page features
Java virtual machine settings
Custom property collection
Monitoring policy settings
Process definition type settings



Searchable topic ID:   urun_rconfproc
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/urun_rconfproc.html

Library | Support | Terms of Use | Feedback