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 > Application Servers > server_name. Then under Server Infrastructure click Java™ Process Management > Process Definition.

[z/OS] On the z/OS platform you must then select either Control, Servant, or Adjunct.

[z/OS] For the z/OS platform, 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 Args information applies 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.

Configuration tab

Start Command (startCommand)

[z/OS]

This command line information only applies to the z/OS platform. It specifies the platform-specific command to launch the server process.

Control process
Data type String
Format START control_JCL_procedure_name
Example START BBO6ACR
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 control_JCL_procedure_name
Example BBO6ASR

Start Command Args (startCommandArgs)

[z/OS]

This command line information only applies to the z/OS platform. It 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
[z/OS] Note: For the z/OS platform, the server short name (JOBNAME) contains 7 characters by default, but you can lengthen the short name to 8 characters.

Stop Command (stopCommand)

[z/OS]

This command line information only applies to the z/OS platform. It 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)

[z/OS]

This command line information only applies to the z/OS platform. It 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

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

Terminate Command (terminateCommand)

[z/OS]

This command line information only applies to the z/OS platform. It specifies the platform-specific command to terminate the server process.

Data type String
Format FORCE server_short_name
Example FORCE BBOS001

Terminate Command Args (terminateCommandArgs)

[z/OS]

This command line information only applies to the z/OS platform. It 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

[AIX HP-UX Linux Solaris Windows]

Specifies the file system directory that the process uses as its current working directory. This setting only applies for the i5/OS platform and for distributed platforms.

Important: 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, you cannot use the administrative console to change this setting. Therefore, to provide compatibility between the applications on a z/OS platform and a distributed platform, set the UNIX System Services directory to the same value that was supplied for the Working Directory option on the distributed platform.

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

Data type String



Subtopics
[AIX HP-UX Linux Solaris Windows] Process logs settings
Monitoring policy settings
[z/OS] Process definition type settings
Related tasks
Defining application server processes
[z/OS] Converting a 7-character server short name to 8 characters
Related reference
Java virtual machine settings
Custom property collection
[AIX HP-UX Linux Solaris Windows] Log and trace settings
Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 9:31:45 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=urun_rconfproc
File name: urun_rconfproc.html