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.)