Process definition settings

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

To view this admin console page ...

Servers > Server Types > WebSphere application servers > myserver. Then, in the Server Infrastructure section, click Java and process management > Process definition.

Executable name

This command line information specifies the executable name that is invoked to start the process.

For example, if we are using a perl script as a generic server, enter the path to the perl.exe module in the Executable name field, and then enter the name of the perl script, along with any arguments, in the Executable arguments field.

Table 1. Data type

Data type

String

Executable arguments

This command line information specifies the arguments that are passed to the executable when starting the process.

We can enter multiple arguments in this field, but they must be separated by carriage returns. Use the Enter key on the keyboard to create these carriage returns.

The following example illustrates how a perl script application that requires two arguments should appear in this field:

perl_application.pl arg1 arg2

Table 2. Data type and units

Data type	String
Units	Command-line arguments

Start command (startCommand)

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

Start command arguments (startCommandArgs)

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

If we have two or more arguments that need to be passed for process definition settings, then specify the arguments on separate lines. For example, if we are specifying port 8089 and a configuration file (location and file name) as command arguments, you would specify:

<startCommandArgs>8089<startCommandArgs>
<startCommandArgs>/opt/payexpert/conf/PCPILogServer.properties<startCommandArgs>

In the admin console, you specify this by entering each argument on a new line.

Do not separate the command arguments with just a space.

Stop command (stopCommand)

This command line information 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
z/OS example	STOP BBOS001;CANCEL BBOS001

Stop command arguments (stopCommandArgs)

This command line information 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
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.

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.

Specify additional arguments for the terminate command.

Data type	String
Format	terminate command arg string
z/OS example	ARMRESTART

Working directory

File system directory that the process uses as its current working directory. This setting only applies for i5/OS and distributed platforms. The process uses this directory to determine the locations of input and output files with relative path names.

Table 3. Data type

Data type

String

Executable target type

Whether the executable target is a Java™ class or an executable JAR file.

Executable target

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 4. Data type

Data type

String

---

Subtopics

Process execution settings
Process logs settings
Monitor policy settings

 

Related tasks

Define appserver processes

 

Related

Java virtual machine settings
Custom property collection
Log and trace settings