Process definition settings

Use this page to configure a process definition. A process definition includes the command line information necessary to start or initialize a process.

To view this administrative console page, click Servers > Server Types > WebSphere application servers > server_name. Then, in the Server Infrastructure section, click Java and process management > Process definition.

On z/OS® you must then click Control, Servant, or Adjunct.

For z/OS, this page provides command-line information for starting, initializing, or stopping a process. Each of the commands for which information is provided can be used for the control process. Only the Start command and Start command arguments properties apply for the servant process. 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 specify the commands for the two different processes on the same panel.

Start command (startCommand)

This command line information specifies the platform-specific command to launch the server process.

z/OS control process
Table 1. Data type, Format, and Example. The following table describes the data type, format, and example.
Data type String
Format START control_JCL_procedure_name
Example START BBO6ACR
z/OS servant process

For the z/OS 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.

Table 2. Data type, Format, and Example. The following table describes the data type, format, and example.
Data type String
Format servant_JCL_procedure_name
Example BBO6ASR

Start command arguments (startCommandArgs)

This command line information specifies any additional arguments required by the start command.

z/OS control process
Table 3. Data type, Format, Example. The following table describes the data type, format, and example.
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
z/OS servant process
Table 4. Data type, Format, Example. The following table describes the data type, format, and example.
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
Avoid trouble Avoid trouble: For z/OS, the server short name (JOBNAME) contains 7 characters by default, but you can lengthen the short name to 8 characters.gotcha

Stop command (stopCommand)

This command line information specifies the platform-specific command to stop the server process

For z/OS, if this field is left blank, then the MVS STOP command is used to stop the generic server.

Table 5. Data type, Format, Example. 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
z/OS example STOP BBOS001;CANCEL BBOS001

Stop command arguments (stopCommandArgs)

This command line information specifies any additional arguments required by the stop command.

Table 6. Data type, Format, Example. 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
z/OS example ;ARMRESTART

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

Terminate command (terminateCommand)

This command line information specifies the platform-specific command to terminate the server process.

Table 7. Data type, Format, Example. Specify arguments for the terminate command.
Data type String
Format FORCE server_short_name
z/OS example FORCE BBOS001

Terminate command arguments (terminateCommandArgs)

This command line information specifies any additional arguments required by the terminate command.

The default is an empty string.
Table 8. Data type, Format, Example. Specify additional arguments for the terminate command.
Data type String
Format terminate command arg string
z/OS example ARMRESTART

Working directory

Specifies the file system directory that the process uses as its current working directory. This setting only applies for IBM® i and distributed platforms. The process uses this directory to determine the locations of input and output files with relative path names.

This field does not display for the z/OS control process.

Avoid trouble Avoid trouble: On z/OS, the working directory is always the UNIX® System Services directory that is defined using the OMVS setting of the RACF® user profile for the user that starts the servant. Therefore, even if you specify a directory in this field, the UNIX System Services directory is used as the working directory. To provide compatibility between applications that run on a z/OS platform and on a distributed platform, set the UNIX System Services directory to the same value that you specify for the Working directory field on your distributed platform system.gotcha
Table 9. Data type. The following table describes the data type.
Data type String

Executable target type

Specifies whether the executable target is a Java class or an executable JAR file.

Executable target

Specifies the name of the executable target. If the target type is a Java class name, this field contains the main() method. If the target type is an executable JAR file, this field contains the name of that JAR file.

Table 10. Data type. The following table describes the data type.
Data type String



Subtopics
Related tasks
Defining application server processes
Converting a 7-character server short name to 8 characters
Related reference
Java virtual machine settings
Custom property collection
Monitoring policy settings
Process definition type settings
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 3:08:41 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-zos&topic=urun_rconfproc
File name: urun_rconfproc.html