Process execution settings

View or change the process execution settings for a server process.

A server process applies to either an application server, a node agent, or a deployment manager.

[AIX Solaris HP-UX Linux Windows][IBM i]If you are running on IBM® i or a distributed operating system, to view this administrative console page for an application server, click Servers > Server Types > WebSphere application servers > server_name. Then, in the Server Infrastructure section, click Java and process management > Process execution.

[z/OS]If you are running on z/OS®, to view this administrative console page for an application server, click Servers > Server Types > WebSphere application servers > server_name. Then, in the Server Infrastructure section, click Java and process management, click either Servant, Control or Adjunct, and then click Process execution.

[AIX Solaris HP-UX Linux Windows][IBM i]To view this administrative console page for a node agent, click System Administration > Node agents > nodeagent_name. Then, in the Server Infrastructure section, click Java and process management > Process definition > Process execution.

[z/OS]To view this administrative console page for a node agent, click System Administration > Node agents > nodeagent_name. Then, under Server Infrastructure, click Java and process management > Process definition > Process execution.

[AIX Solaris HP-UX Linux Windows][IBM i]To view this administrative console page for a deployment manager, click System Administration > Deployment manager. Then, in the Server Infrastructure section, click Java and process management > Process definition > Process execution.

[z/OS]To view this administrative console page for a deployment manager, click System Administration > Deployment manager. Then, in the Server Infrastructure section, click Java and process management, click either Servant, Control or Adjunct, and then click Process execution.

Process Priority

Specifies the operating system priority for the process. The administrative process that starts the server must have root operating system authority to accept this setting.

[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]This setting is not available for managed WebSphere® Application Server Liberty servers. For information about managed Liberty servers, see the Modernized Runtime Extension for Java (MoRE) documentation.

Information Value
Data type Integer
Default 20

UMASK

Specifies the user mask under which the process runs (the file-mode permission mask).

[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]Beginning with version 1.0.3.0, you can set a user mask for managed Liberty servers.

Note:
To support system management functions, the deployment manager and application servers must run with the stated UMASK default value.
Information Value
Data type Integer
Default 022 (for UNIX)
Default 007 (for z/OS)
[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]Default 027 (beginning with 1.0.3.0 for managed Liberty servers)

You can change the default value of UMASK for the deployment manager and application servers to a more strict UMASK setting (027 for UNIX), but this change can have unintended consequences for stack products, add-ons, non-IBM products, and legacy scripts and processes.

[z/OS]If the process is running in a servant, you can either specify a different user mask setting in this field or you can define a new environment variable for the servant that changes this setting. The new environment variable is _BPX_BATCH_UMASK. You define this new environment variable by using the administrative console. To view the administrative console page, click Environment > WebSphere variables. To define the new variable, select the appropriate scope from the list of available options and then click New to create the name _BPX_BATCH_UMASK and set the wanted value.
Note: After defining and setting _BPX_BATCH_UMASK, you will need to restart the server to pick up the new UMASK setting.
[Linux][AIX][z/OS][HP-UX][IBM i][Solaris]

Run As User

Specifies the user that the process runs as. This user ID must be defined to the security system.

[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]Beginning with version 1.0.3.0, you can specify the user that the process runs as for managed Liberty servers.

[z/OS]This field does not apply if you are running on a z/OS operating system. z/OS users must use RACF to associate a user to an address space. A process display shows the RACF associated user as the running user.

Avoid trouble: For the Application Server to transition to the user that is specified in this option, the user that is starting the process must be a root user or user who is defined in Run As User. This is a restriction of the operating system. After an update and if the server does not start, make sure that the ownership of the profile directory is assigned to the non-root user ID.
[Linux][AIX][HP-UX][Solaris]Avoid trouble: When you use the Run As User capability, environment settings are not automatically changed. By default, the application server receives the environment settings, including the $HOME and $USER values, for the user that started the process and not the Run As User value. If any applications that are deployed on the application server require an environment setting that is set to a specific value for the Run As User, you must either:
  • Define the environment setting before you start the server.
  • For the $HOME value, grant write permission for the Run As User value in the operating system.
If you are using the Run As User capability, it is not recommended that you rely on environment variables, but rather specify the values directly for the application.

[Windows]This field is ignored if you are running Microsoft Windows operating systems because Windows user accounts are not managed by the Application Server.

Information Value
Data type String

[IBM i]For the IBM i operating system, extra steps are required to run as a user ID other than QEJBSVR. For more information, see the Security section of the WebSphere Application Server for iSeries online documentation.

[Linux][AIX][z/OS][HP-UX][Solaris]

Run As Group

Specifies the group that the process is a member of and runs as.

[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]Beginning with version 1.0.3.0, you can specify the group that the process is a member of and runs as for managed Liberty servers.

[z/OS]This field does not apply if you are running on a z/OS operating system. z/OS users must use RACF to associate a group to an address space. A process display shows the RACF associated group as the running user.

  • Note: If the user is a member of secondary groups, the server process does not have the user's access permissions to those groups by default. For the process to have those permissions, set this environment variable in the operating system before starting WebSphere Application Server: __JNI_PROCESS_INITGROUPS
  • [Linux][AIX][HP-UX][Solaris]Avoid trouble: When you use the Run As Group capability, environment settings are not automatically changed. By default, the application server receives the environment settings, including the $HOME and $USER values, for the user that started the process and not the Run As Group value. If any applications that are deployed on the application server require an environment setting that is set to a specific value for the Run As Group, you must either:
    • Define the environment setting before you start the server.
    • For the $HOME value, grant write permission for the Run As Group value in the operating system.
    If you are using the Run As Group capability, it is not recommended that you rely on environment variables, but rather specify the values directly for the application.

If the runAsGroup value is specified, then that value is added to the secondary group list. If the runAsGroup value specified is not the runAsUser's primary group, the primary group is included in the secondary group list only if the user is defined as part of the group list in the group database, typically /etc/group.

[Windows][IBM i]This field is ignored.

Information Value
Data type String
[Linux][AIX][z/OS][HP-UX][Solaris]

Run In Process Group

Specifies a specific process group for the process. A process group is a mechanism that the operating system uses to logically associate multiple processes and operate on them as a single unit. Usually, the operating system uses this mechanism for signal distribution.

[9.0.5.28 or later][Modernized Runtime Extension for Java (MoRE)]This setting is not available for managed WebSphere Application Server Liberty servers.

[z/OS]This field does not apply if you are running on a z/OS operating system. z/OS users must use RACF to associate a process group to an address space. A process display shows the RACF associated process group as the running user.

Specific operating systems might allow other operations to be performed on a process group. Refer to your operating system documentation for more information on the operations that can be performed on a process group.

[Windows][IBM i]This field is ignored.

Information Value
Data type Integer
Default 0, which indicates that the process is not assigned to a specific process group.