(Click to open topic with navigation)
2.8.1 Job Attributes
FLAGS | |
---|---|
Format: | <FLAG>[:<FLAG>]... |
Default: | --- |
Description: | Specifies job specific flags. |
Example: |
FLAGS=ADVRES:RESTARTABLE The job can restart and should only utilize reserved resources. |
QDEF | |
---|---|
Format: | <QOS_NAME> |
Default: | [DEFAULT] |
Description: | Specifies the default QOS associated with the object. |
Example: |
QDEF=premium The object is assigned the default QOS premium. |
By default, jobs may access QoSs 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 QoSs 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.
ARRAYJOBPARLOCK | |
---|---|
Format: | --- |
Default: | --- |
Description: | Specifies that the job array being submitted should not span across multiple partitions. This locks all sub jobs of the array to a single partition. If you want to lock all job arrays to a single partition, specify the ARRAYJOBPARLOCK parameter in moab.cfg to force this behavior on a global scale. |
Example: |
> msub -t moab.[1-5]%3 -l walltime=30,flags=arrayjobparlock |
ARRAYJOBPARSPAN | |
---|---|
Format: | --- |
Default: | --- |
Description: | Specifies that the job array being submitted should span across multiple partitions. This is the default behavior in Moab, unless the ARRAYJOBPARLOCK parameter is specified in moab.cfg. This job flag overrides the ARRAYJOBPARLOCK parameter so that job arrays can be allowed to span multiple partitions at submit time. |
Example: |
> msub -t moab.[1-5]%3 -l walltime=30,flags=arrayjobparspan |
GRESONLY | |
---|---|
Format: | GRESONLY |
Default: | False |
Description: | Uses no compute resources such as processors, memory, and so forth; uses only generic resources. |
Example: |
> msub -l gres=matlab,walltime=300 |
NOQUEUE | |
---|---|
Format: | NOQUEUE |
Default: | Jobs remain queued until they are able to run |
Description: | Specifies that the job should be removed it is unable to allocate resources and start execution immediately. |
Example: |
FLAGS=NOQUEUE The job should be removed unless it can start running at submit time. This functionality is identical to the resource manager extension QUEUEJOB:FALSE. |
PREEMPTEE | |
---|---|
Format: | PREEMPTEE |
Default: | Jobs may not be preempted by other jobs |
Description: | Specifies that the job may be preempted by other jobs which have the PREEMPTOR flag set. |
Example: |
FLAGS=PREEMPTEE The job may be preempted by other jobs which have the PREEMPTOR flag set. |
PREEMPTOR | |
---|---|
Format: | PREEMPTOR |
Default: | Jobs may not preempt other jobs |
Description: | Specifies that the job may preempt other jobs which have the PREEMPTEE flag set . |
Example: |
FLAGS=PREEMPTOR The job may preempt other jobs which have the PREEMPTEE flag set. |
PURGEONSUCCESSONLY | |
---|---|
Format | PURGEONSUCCESSONLY |
Default | Completed jobs are sent to a queue for a short period of time before Moab purges them from the system. |
Description | Specifies that Moab should only purge the job from the completed queue if it completed successfully. If the job failed, Moab will keep it in the queue indefinitely to allow you to restart it at any time. This flag is particularly useful for setup and take down jobs in job workflows. See Creating Workflows with Job Templates for more information. |
Example |
FLAGS=PURGEONSUCCESSONLY If the job fails, Moab will not purge it from the completed job queue. |
RESTARTABLE | |
---|---|
Format: | RESTARTABLE |
Default: | Jobs may not be restarted if preempted. |
Description: | Specifies jobs can be requeued and later restarted if preempted. |
Example: |
FLAGS=RESTARTABLE The associated job can be preempted and restarted at a later date. |
SUSPENDABLE | |
---|---|
Format: | SUSPENDABLE |
Default: | Jobs may not be suspended if preempted. |
Description: | Specifies jobs can be suspended and later resumed if preempted. |
Example: |
FLAGS=SUSPENDABLE The associated job can be suspended and resumed at a later date. |
SYSTEMJOB | |
---|---|
Format: | SYSTEMJOB |
Default: | N/A |
Description: | Creates an internal system job that does not require resources. |
Example: |
FLAGS=SYSTEMJOB |
WIDERSVSEARCHALGO | |
---|---|
Format: | <BOOLEAN> |
Default: | --- |
Description: | When Moab is determining when and where a job can run, it either searches for the most resources or the longest range of resources. In almost all cases searching for the longest range is ideal and returns the soonest starttime. In some rare cases, however, a particular job may need to search for the most resources. In those cases this flag can be used to have the job find the soonest starttime. The flag can be specified at submit time, or you can use mjobctl -m to modify the job after it has been submitted. See the RSVSEARCHALGO parameter. |
Example: |
> msub -l flags=widersvsearchalgo > mjobctl -m flags+=widersvsearchalgo job.1 |
Related Topics