C-LANG Statements › PROCESS_PRIORITY Statement—Specify the Process Priority of a UNIX or i5/OS Job

PROCESS_PRIORITY Statement—Specify the Process Priority of a UNIX or i5/OS Job

The PROCESS_PRIORITY statement specifies the process priority of a UNIX or i5/OS job. Process priority determines the order in which processes are scheduled on the processor. Depending on the priority level, process priority can speed up or slow down a process.

Supported Job Types

This statement is optional for the following job types:

• i5/OS
• UNIX

Syntax

This statement has the following format:

PROCESS_PRIORITY [HIGH|ABOVE_NORMAL|NORMAL|BELOW_NORMAL|IDLE]

HIGH

Indicates processes that must be executed immediately. These processes can use nearly all available CPU time.

ABOVE_NORMAL

Indicates processes that have priority above the normal level but below the high level.

NORMAL

Indicates processes without special scheduling needs. This is the default.

BELOW_NORMAL

Indicates processes that have priority above the idle level but below the normal level.

IDLE

Indicates processes that will run only when the system is idle.

Notes:

• If you do not specify the process priority in the job definition, the job's process priority is set to NORMAL by default.
• You can only set a UNIX job's process priority to a level above normal if the job runs on a computer with the agent started by the root account. If the agent is not started by root and you set the process priority to a level above normal, the job runs with the normal process priority.
• For UNIX jobs running on an i5/OS system, you can increase the process priority above normal only if the agent is running under a profile that has *JOBCTL authority. If the agent is not running under a profile that has *JOBCTL authority and you set the process priority to a level above normal, the job runs with the normal process priority.

Example: Set the Process Priority for a UNIX Job

This example sets the process priority for a UNIX job to ABOVE_NORMAL:

AGENT LINUXAG
SCRIPTNAME /payroll/sort
PROCESS_PRIORITY ABOVE_NORMAL

Example: Set the Process Priority for an i5/OS Job

This example sets the process priority for an i5/OS job to HIGH:

AGENT I5AG
CLPNAME PAYROLL
PROCESS_PRIORITY HIGH