C-LANG Statements › ULIMIT Statement—Specify UNIX Resource Limits

ULIMIT Statement—Specify UNIX Resource Limits

The ULIMIT statement modifies resource limits on the agent computer for the duration of the job. For example, you can define a job that modifies the maximum core file size and CPU times on the UNIX computer.

Supported Job Type

This statement is optional for the UNIX job type.

Syntax

This statement has the following format:

ULIMIT TYPE(C|D|F|M|N|S|T) SOFT(soft_value) [HARD(hard_value)]

TYPE(C|D|F|M|N|S|T)

Specifies the resource type. Options are the following:

• C—Specifies the core file size in kilobytes (KB).
• D—Specifies the data segment size in kilobytes (KB).
• F—Specifies the maximum file size in kilobytes (KB).
• M—Specifies the process virtual size in kilobytes (KB).
• N—Specifies the number of files.
• S—Specifies the stack size in kilobytes (KB).
• T—Specifies the CPU time in seconds.

SOFT(soft_value)

Defines the usage (soft) limit for the specified resource type. The soft limit can be increased up to the specified hard limit and can be changed without root authority.

Limits: Any numeric digits or you can specify unlimited; the value must be less than or equal to the hard limit

HARD(hard_value)

(Optional) Defines the maximum usage (hard) limit for the specified resource type. The hard limit can only be increased by the root user. Any user ID can decrease a hard limit.

Limits: Any numeric digits or you can specify unlimited; the value must be greater than or equal to the soft limit

Default: soft limit value

Note: If the job runs under a non-root user ID and the value specified in the job definition is greater than the current hard limit on the UNIX system, the hard limit will not be increased.

Notes:

• The entire value can be up to 4096 characters.
• To specify multiple ulimit values, define a separate ULIMIT statement for each value.
• The ulimit values are applied before the user profile is sourced. Therefore, the values can be overridden by the /etc/profile script, the .profile script, or any other user logon scripts.

Example: Specify Multiple Resource Limits

This example runs the procrun.sh script on the UNIXAGT agent. The job modifies the following resource limits on the UNIX computer:

• The core file size limit is 100 KB (soft limit). The size can increase to 200 KB (hard limit).
• The stack size limit is 250 KB (soft limit). The size can increase to 300 KB (hard limit).
• The CPU time limit is 1000 seconds (soft limit). The time can increase to 4000 seconds (hard limit).
• The process virtual size limit is 3332 KB (soft limit). The size can increase to an unlimited value.

  AGENT UNIXAGT
  SCRIPTNAME /ul/procrun.sh
  ULIMIT TYPE(C) SOFT(100) HARD(200)
  ULIMIT TYPE(S) SOFT(250) HARD(300)
  ULIMIT TYPE(T) SOFT(1000) HARD(4000)
  ULIMIT TYPE(M) SOFT(3332) HARD(unlimited)