Configuring properties of the native job launcher [NativeJobLauncher]
About this task
JobManager.ini
file, the section
containing the properties of the native job launcher is named: [NativeJobLauncher]
- AllowRoot
-
Applies to UNIX™ systems only. Specifies if the root user can run jobs on the agent. It can be
true
orfalse
. The default is false. This property does not apply to IBM i, use the AllowQSECOFR option instead - AllowQECOFR
- Applies to IBM i systems only. Specifies if
QSECOFR user can run jobs on the agent. It can be
true
orfalse
. The default istrue
. Add a line like AllowQSECOFR =false
to the JobManager.ini file to deny job execution to QSECOFR. - CheckExec
- If
true
, before launching the job, the agent checks both the availability and the execution rights of the binary file. The default istrue
. - DefaultWorkingDir
- Specifies the working directory of native jobs. You can also specify the value for the working directory when creating or editing the job definition in the Workload Designer. When specified in the Workload Designer, this value overrides the value specified for the DefaultWorkingDir property. If you do not specify any working directories, the <TWS_home>\bin directory is used.
- JobUnspecifiedInteractive
- Applies to Windows™ operating
systems only. Specifies if native jobs are to be launched in interactive
mode. It can be
true
orfalse
. The default isfalse
. - KeepCommandTraces
- Set to
true
to store the traces of the method invocation for actions performed on a job definition, for example, when selecting from a picklist. These files are stored in the path /opt/HCL/TWA_<TWS_user>/TWS/stdlist/JM/r3batch_cmd_exec. The default setting isfalse
. - KeepJobCommandTraces
- Set to
true
to store the traces of the method invocation for actions performed on a job instance, for example, viewing a spool list. These files are stored in the .zip file of the job instance. The default setting istrue
. - LoadProfile
- Applies to agents on Windows servers only. Specifies if the user profile is to be
loaded. It can be
true
orfalse
. The default istrue
. - MonitorQueueName
- Specifies the name of the queue where the IBM i jobs are monitored. If you do not specify this property, the default queue (QBATCH) is used.
- PortMax
- The maximum range of the port numbers used by the task launcher to communicate with the Job Manager. The default is 0, meaning that the operating system assigns the port automatically.
- PortMin
- The minimum range of the port numbers used by the task launcher to communicate with the Job Manager. The default is 0, meaning that the operating system assigns the port automatically.
- PostJobExecScriptPathName
- The fully qualified path of the script file that you want to run
when the job completes. By default, this property is not present in
the
JobManager.ini
file. If you do not specify any file path or the script file doesn't exist, no action is taken.This property applies to dynamic agent and z/OS agent. For details about running a script when a job completes, see User's Guide and Reference.
- PromotedNice
- Used in workload service assurance. This
property is not supported on the Agent for z/OS.
For UNIX and Linux operating systems only, assigns the priority value to a critical job that needs to be promoted so that the operating system processes it before others. Applies to critical jobs or predecessors that need to be promoted so that they can start at their critical start time.
Boundary values vary depending upon each specific platform, but generally lower values correspond to higher priority levels and vice versa. The default is -1.
Be aware that:- The promotion process is effective with negative values only. If you set a positive value, the system runs it with the -1 default value.
- An out of range value (for example -200), prompts the operating system to automatically promote the jobs with the lowest allowed nice value.
- Overusing the promotion mechanism (that is, defining an exceedingly high number of jobs as mission critical and setting the highest priority value here) might overload the operating system, negatively impacting the overall performance of the workstation.
- PromotedPriority
- Used in workload service assurance. This
property is not supported on the Agent for z/OS.
For Windows operating systems only, sets to this value the priority by which the operating system processes a critical job when it is promoted. Applies to critical jobs or predecessors that need to be promoted so that they can start at their critical start time. Valid values are:
High
AboveNormal
(the default)Normal
BelowNormal
Low
orIdle
Note that if you a set a lower priority value than the one non-critical jobs might be assigned, no warning is given.
- RequireUserName
-
When
true
, requires that you add the user name in the JSDL job definition.Whenfalse
, runs with the user name used by job manager, that is:- TWS_user on UNIX™ and Linux™ systems
- The local system account on Windows™ systems
The default is
false
. - RunExecutablesAsIBMiJobs
- If you set this property to
true
, you can define IBM i jobs as generic jobs without using the XML definition. Generic jobs are automatically converted to IBM i jobs. As a side effect, generic jobs cannot be run when this parameter is enabled (RunExecutablesAsIBMiJobs=true
). There is no default value because this property is not listed in theJobManager.ini
file after the agent installation.If you set this property to
true
, ensure that the user you used to install the agent has been granted the*ALLOBJ
special authority. - RunInteractiveJobOnInvalidSession
- Applies only to native and executable jobs starting interactive programs
running on dynamic agents
installed on Windows operating systems. Interactive programs run only if the job user
has an active session open when the job runs. If there is no active session for the
job user, the job behavior is defined by this property, as follows.
Set the property to
true
to enable jobs to start interactive programs even if there is no active session for the job user. Set the property tofalse
to prevent jobs from starting interactive programs if there is no active session for the job user. - ScriptSuffix
- The suffix to be used when creating the script files. It is:
.cmd
- For Windows™
.sh
- For UNIX™
- VerboseTracing
- Enables verbose tracing. It is set to
true
by default.