Job classes
Job classes specify limits for resource consumption by batch jobs. A job class establishes a policy for resource consumption by a set of batch jobs. Through this policy, execution time, number of concurrent jobs, job log, and job output queue storage can be controlled. This topic lists the limits enforced by job classes.
Job classes can be configured using the console and stored in an .xml file called jobclass.xml under a profile_root/config/cells/cell_name/gridjobclasses/ directory. Each job is assigned to a job class.
A job class establishes policy for:
- Execution time
- Maximum time a job can run before being automatically canceled by the system.
- Concurrent jobs
- Maximum number of concurrently dispatched jobs of a given job class.
- Job log retention
- Rule for deleting aged job logs. Retention can be specified by either space or time:
- Space
- Specified in megabytes. Job logs of the specified class are deleted from oldest to newest on an endpoint if the sum of space used by job logs exceeds the specified maximum.
- Time
- Specified as an integral number of days. Job logs of the specified class older than N days old are automatically deleted by the system.
- Job output queue
- Rule for deleting jobs on the job output queue. A job is on the output queue after it has either completed, or stopped, or canceled. Output queue policy allows for automatic purging of the output queue by:
- Number
- Specified as an integral number of jobs. When jobs on the output queue of the specified class exceed this number, they are deleted oldest to newest until the total is less than the specified number.
- Time
- Specified as an integral number of days. Job logs of the specified class older than N days old are automatically deleted by the system.
Following are the limits enforced by job classes:
- maxExecutionTime
- An integer, which specifies the maximum number of seconds a job is allowed to run before it is canceled.
- maxConcurrentJob
- An integer, which specifies the maximum number of jobs belonging to same job class that can be dispatched to a cell. When this limit is reached, new jobs belonging to the same job class are not dispatched until the ones that are currently running complete execution.
- maxClassSpace
- An integer that specifies the amount of space, in megabytes, allowed for a job log belonging to this job class. When this limit is reached, job logs are deleted oldest to newest.
- maxFileAge
- An integer, which specifies the number of days a job log of this job class is stored. Job logs older than the number of days are deleted.
- maxJob
- An integer, which specifies the maximum number of jobs of this class allowed on the output queue. When this limit is exceeded, the job is automatically purged, oldest to newest.
- maxJobAge
- An integer value which specifies the maximum of number of days a job of this class is allowed on the output queue. Jobs older than this value are automatically purged.
Related concepts
Batch job classification Batch applications, jobs, and job definitions Service policies for batch jobs
Job scheduler job class settings