Maui Scheduler

Job Attributes/Flags Overview

Job Attributes

Attribute Format Default Description Example

FLAGS <FLAG>[;<FLAG>]... [NONE] specifies job specific flags FLAGS=ADVRES;DEDICATED
(The job should only utilize reserved resources and should only use resources on hosts which can be exclusively dedicated)

PDEF <PARTITION_NAME> [DEFAULT] specifies the default partition associated with the object. PDEF=P1
(The object is assigned the default partition P1)

PLIST* <PARTITION_NAME>[^|&]
[:<PARTITION_NAME>[^|&]]... [ALL] specifies the list of partitions the object can access. If no partition list is specified, the object is granted default access to all partitions. PLIST=OldSP:Cluster1:O3K
(The object can access resources located in the OldSP, Cluster1, and/or O3K partitions)

QDEF <QOS_NAME> [DEFAULT] specifies the default QOS associated with the object. QDEF=premium
(The object is assigned the default QOS premium)

QLIST* <QOS_NAME>[^|&]
[:<QOS_NAME>[^|&]]... <QDEF> specifies the list of QoS's the object can access. If no QOS list is specified, the object is granted access only to its default partition/ QLIST=premium:express:bottomfeeder
(The object can access any of the 3 QOS's listed)

*NOTE: By default, jobs may access QOS's based on the 'logical or' of the access lists associated with all job credentials. For example, a job associated with user John, group staff, and class batch may utilize QOS's accessible by any of the individual credentials. Thus the job's QOS access list, or QLIST, equals the 'or' of the user, group, and class QLIST's. (i.e., JOBQLIST = USERQLIST | GROUPQLIST | CLASSQLIST). If the ampersand symbol, '&', is associated with any list, this list is logically and'd with the other lists. If the carat symbol, '^', is associated with any object QLIST, this list is exclusively set, regardless of other object access lists using the following order of precedence user, group, account, QOS, and class. These special symbols affect the behavior of both QOS and partition access lists.

Job Flags

Flag	Format	Default	Description	Example
ADVRES	ADVRES[:<RESID>]	Use available resources where ever found, whether inside a reservation or not.	specifies the job may only utilize accessible, reserved resources. If <RESID> is specified, only resources in the specified reservation may be utilized.	`FLAGS=ADVRES:META.1` (The job may only utilize resources located in the `META.1` reservation)
BENCHMARK	BENCHMARK	N/A	N/A	`FLAGS=BENCHMARK`
BESTEFFORT	BESTEFFORT	N/A	N/A	`FLAGS=BESTEFFORT`
BYNAME	BYNAME	N/A	N/A	`FLAGS=BYNAME`
DEDICATED	DEDICATED	Use resources according to the global NODEACCESSPOLICY	specifies that the job should not share node resources with tasks from any other job	FLAGS=DEDICATED (The job will only allocate resources from nodes which can be exclusively dedicated to this job)
HOSTLIST	HOSTLIST=<HOSTNAME> [:<HOSTNAME>]...	The job may utilize any available resource regardless of hostname	specifies the list of hosts which should be used by the job. If more hosts are specified than are needed to meet the jobs total task requirements, Maui will select needed hosts from the list. If fewer hosts are specified than are needed to meet the job's total task requirements, Maui will select all listed hosts and attempt to locate additional resources elsewhere.	`HOSTLIST=node003:node006:node009` (Maui will allocate resources using the specified hosts)
NOQUEUE	NOQUEUE	Jobs remain queued until the are able to run	specifies that the job should be removed it is is unable to allocate resources and start execution immediately.	`FLAGS=NOQUEUE` (The job should be removed unless it can start running at submit time.)
PREEMPTEE	PREEMPTEE	Jobs may not be preempted by other jobs	Specifies that the job may be preempted by other jobs which have the PREEMPTOR flag set.	`FLAGS=PREEMPTEE` (The job may be preempted by other jobs which have the 'PREEMPTOR' flag set)
PREEMPTOR	PREEMPTOR	Jobs may not preempt other jobs	Specifies that the job may preempt other jobs which have the PREEMPTEE flag set	`FLAGS=PREEMPTOR` (The job may preempt other jobs which have the 'PREEMPTEE' flag set)
PRESTART	PRESTART	Jobs are started only after the first scheduling iteration	NOTE: used only in simulation mode to pre-populate a system.	`FLAGS=PRESTART`
RESTARTABLE	RESTARTABLE	Jobs may not be restarted if preempted.	Specifies jobs can be 'requeued' and later restarted if preempted	FLAGS=RESTARTABLE (The associated job can be preempted and restarted at a later date)
SHAREDNODE	SHAREDNODE	N/A	N/A	N/A
SPAN	SPAN	Jobs may only access resources within a single partition	Allows jobs to utilize resources from multiple partitions simultaneously	FLAGS=SPAN (The job can be allocated and utilize resources from more than one accessible partition simultaneously.)

Attribute	Format	Default	Description	Example
FLAGS	<FLAG>[;<FLAG>]...	[NONE]	specifies job specific flags	`FLAGS=ADVRES;DEDICATED` (The job should only utilize reserved resources and should only use resources on hosts which can be exclusively dedicated)
PDEF	<PARTITION_NAME>	[DEFAULT]	specifies the default partition associated with the object.	`PDEF=P1` (The object is assigned the default partition `P1`)
PLIST*	<PARTITION_NAME>[^\|&] [:<PARTITION_NAME>[^\|&]]...	[ALL]	specifies the list of partitions the object can access. If no partition list is specified, the object is granted default access to all partitions.	`PLIST=OldSP:Cluster1:O3K` (The object can access resources located in the `OldSP`, `Cluster1`, and/or `O3K` partitions)
QDEF	<QOS_NAME>	[DEFAULT]	specifies the default QOS associated with the object.	`QDEF=premium` (The object is assigned the default QOS `premium`)
QLIST*	<QOS_NAME>[^\|&] [:<QOS_NAME>[^\|&]]...	<QDEF>	specifies the list of QoS's the object can access. If no QOS list is specified, the object is granted access only to its default partition/	`QLIST=premium:express:bottomfeeder` (The object can access any of the 3 QOS's listed)