<div class="sright"> <div class="sub-content-head"> Maui Scheduler </div> <div id="sub-content-rpt" class="sub-content-rpt" > <div class="tab-container docs" id="tab-container"> <div class="topNav"> <div class="docsSearch"> </div> <div class="navIcons topIcons"> <a href="index.php"><img src="/resources/docs/images/home.png" title="Home" alt="Home" border="0"></a> <a href="index.php"><img src="/resources/docs/images/upArrow.png" title="Up" alt="Up" border="0"></a> <a href="a.esecurity.php"><img src="/resources/docs/images/prevArrow.png" title="Previous" alt="Previous" border="0"></a> <a href="a.gcommandoverview.php"><img src="/resources/docs/images/nextArrow.png" title="Next" alt="Next" border="0"></a> </div> <h1>Appendix F: Maui Parameters</h1> See the <a href="3.4configure.php">Parameters Overview</a> in the Maui Admin Manual for further information about specifying parameters. <table class="tableFormat01"> <tbody> <tr> <td colspan="2" class="featureName"><a name="accountcfg"></a> <b>ACCOUNTCFG[<ACCOUNTID>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <br> <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QLIST</b>, <b>QDEF</b>, <b>PLIST</b> , <b>PDEF</b>, <b>FLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies account specific attributes. See the <a href="jobflagoverview.php"> flag overview</a> for a description of legal flag values. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ACCOUNTCFG[projectX] MAXJOB=50 QDEF=highprio</pre></div> <p>(up to 50 jobs submitted under the account ID <tt>projectX</tt> will be allowed to execute simultaneously and will be assigned the QOS <tt> highprio</tt> by default.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="afsweight"></a> <b>AFSWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight to be applied to the account fairshare factor. (See <a href="6.3fairshare.php">Fairshare Priority Factor</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>AFSWEIGHT 10</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="accountweight"></a> <b>ACCOUNTWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight to be applied to the specified account priority. (See <a href="5.1.2priorityfactors.php#cred">Credential Priority Factor</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ACCOUNTWEIGHT 100</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="admin1"></a> <b>ADMIN1</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of user names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">root</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">users listed under the parameter ADMIN1 are allowed to perform any scheduling function. They have full control over the scheduler and access to all data. The first user listed in the ADMIN1 user list is considered to be the 'primary admin' and is the ID under which maui must be started and run. Valid values include user names or the keyword 'ALL'.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ADMIN1 mauiuser steve scott jenny</pre></div> <p>(all users listed have full access to maui control commands and maui data. Maui must be started by and run under the 'mauiuser' user id since mauiuser is the primary admin.</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="admin2"></a> <b>ADMIN2</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of user names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">users listed under the parameter ADMIN2 are allowed to change all job attributes and are granted access to all informational Maui commands. Valid values include user names or the keyword 'ALL'.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ADMIN2 jack karen</pre></div> <p>(jack and karen can modify jobs, i.e., 'canceljob, setqos, setspri, etc.) and can run all Maui information commands).</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="admin3"></a> <b>ADMIN3</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of user names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">users listed under the parameter ADMIN3 are allowed access to all informational maui commands. They cannot change scheduler or job attributes. Valid values include user names or the keyword 'ALL'.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ADMIN3 ops</pre></div> <p>(user <tt>ops</tt> can run all informational command such as 'checkjob' or checknode')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="amcfg"></a> <b>AMCFG</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more <b>key-value</b> pairs as described in the <a href="6.4allocationmanagement.php#config">Allocation Manager Configuration Overview</a></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">N/A</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the interface and policy configuration for the scheduler-allocation manager interface. Described in detail in the <a href="6.4allocationmanagement.php#config">Allocation Manager Configuration Overview</a></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>AMCFG[bank] TYPE=QBANK HOST=supercluster.org PORT=7111 DEFERJOBONFAILURE=FALSE </pre></div> <p>(the QBank server will be contacted at port 7111 on host supercluster.org)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="backfilldepth"></a> <b>BACKFILLDEPTH</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number idle jobs to evaluate for backfill. The backfill algorithm will evaluate the top <X> priority jobs for scheduling. By default, all jobs are evaluated.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>BACKFILLDEPTH 128</pre></div> <p>(evaluate only the top 128 highest priority idle jobs for consideration for backfill)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="backfillmetric"></a> <b>BACKFILLMETRIC</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following <b>PROCS</b>, <b>PROCSECONDS</b>, <b>SECONDS</b> , <b>PE</b>, or <b>PESECONDS</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>PROCS</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the criteria used by the backfill algorithm to determine the 'best' jobs to backfill. Only applicable when using BESTFIT or GREEDY backfill algorithms</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>BACKFILLMETRIC PROCSECONDS</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="backfillpolicy"></a> <b>BACKFILLPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>FIRSTFIT</b>, <b>BESTFIT</b>, <b>GREEDY</b> , or <b>NONE</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>FIRSTFIT</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies what backfill algorithm will be used</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>BACKFILLPOLICY BESTFIT</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="bfchunkduration"></a> <b>BFCHUNKDURATION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (chunking disabled)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the duration during which freed resources will be aggregated for use by larger jobs. Used in conjunction with <b>BFCHUNKSIZE</b>. See <a href="8.2backfill.php#config">Configuring Backfill</a> for more information.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"><div class="example"><pre> BFCHUNKDURATION 00:05:00 BFCHUNKSIZE 4 </pre></div> <p>(aggregate backfillable resources for up to 5 minutes, making resources available only to jobs of size 4 or larger) </p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="bfchunksize"></a> <b>BFCHUNKSIZE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (chunking disabled)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum job size which can utilize <i>chunked</i> resources. Used in conjunction with <b>BFCHUNKDURATION</b>. See <a href="8.2backfill.php#config">Configuring Backfill</a> for more information</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"><div class="example"><pre> BFCHUNKDURATION 00:05:00 BFCHUNKSIZE 4 </pre></div> <p>(aggregate backfillable resources for up to 5 minutes, making resources available only to jobs of size 4 or larger) </p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="bfprioritypolicy"></a> <b>BFPRIORITYPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>RANDOM</b>, <b>DURATION</b>, or <b>HWDURATION</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">NONE</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies policy to use when prioritizing backfill jobs for preemption </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"><div class="example"><pre> BFPRIORITYPOLICY DURATION </pre></div> <p>(use length of job in determining which backfill job to preempt) </p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="bypassweight"></a> <b>BYPASSWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight to be applied to a job's backfill bypass count when determining a job's priority</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>BYPASSWEIGHT 5000</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="checkpointexpirationtime"></a> <b>CHECKPOINTEXPIRATIONTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">INFINITY</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how 'stale' checkpoint data can be before it is ignored and purged.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CHECKPOINTEXPIRATIONTIME 1:00:00:00</pre></div> <p>(Expire checkpoint data which has been stale for over one day)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="checkpointfile"></a> <b>CHECKPOINTFILE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">maui.ck</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">name (absolute or relative) of the Maui checkpoint file.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CHECKPOINTFILE /var/adm/maui/maui.ck</pre></div> <p>(Maintain the Maui checkpoint file in the file specified)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="checkpointinterval"></a> <b>CHECKPOINTINTERVAL</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:05:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">time between automatic Maui checkpoints</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CHECKPOINTINTERVAL 00:15:00</pre></div> <p>(Maui should checkpoint state information every 15 minutes)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="classcfg"></a> <b>CLASSCFG[<CLASSID>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QLIST</b>, <b>QDEF</b>, <b>PLIST</b> , <b>PDEF</b>, <b>FLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies class specific attributes. See the <a href="jobflagoverview.php"> flag overview</a> for a description of legal flag values. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CLASSCFG[batch] MAXJOB=50 QDEF=highprio</pre></div> <p>(up to 50 jobs submitted to the class <tt>batch</tt> will be allowed to execute simultaneously and will be assigned the QOS <tt>highprio</tt> by default.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="classweight"></a> <b>CLASSWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight to be applied to the class priority of each job (See <a href="5.1.2priorityfactors.php#cred">Cred Factor</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CLASSWEIGHT 10</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="clientcfg"></a> <b>CLIENTCFG[<X>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more of the following: <b>CSALGO</b> or <b>CSKEY</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the shared secret key and encryption algorithm which Maui will use to communicate with the named peer daemon. <b>NOTE:</b> this parameter may only be specified in the <b>maui-private.cfg</b> config file)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CLIENTCFG[silverB] CSKEY=apple7</pre></div> <p>(Maui will use the session key <tt>apple7</tt> for encrypting and decrypting messages sent from <tt>silverB</tt>)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="clienttimeout"></a> <b>CLIENTTIMEOUT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:00:30</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">time which Maui client commands will wait for a response from the Maui server (NOTE: may also be specified as an environment variable)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CLIENTTIMEOUT 00:15:00</pre></div> <p>(Maui clients will wait up to 15 minutes for a response from the server before timing out)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="credweight"></a> <b>CREDWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the <a href="5.1.2priorityfactors.php#cred">credential component</a> weight </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>CREDWEIGHT 2</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="defaultclasslist"></a> <b>DEFAULTCLASSLIST</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of one or more <STRING>'s</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the default classes supported on each node for RM systems which do not provide this information</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DEFAULTCLASSLIST serial parallel</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="defercount"></a> <b>DEFERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">24</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number of times a job can be deferred before it will be placed in batch hold.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DEFERCOUNT 12</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="deferstartcount"></a> <b>DEFERSTARTCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies number of time a job will be allowed to fail in its start attempts before being deferred.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DEFERSTARTCOUNT 3</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="defertime"></a> <b>DEFERTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies amount of time a job will be held in the deferred state before being released back to the Idle job queue</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DEFERTIME 0:05:00</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="diskweight"></a> <b>DISKWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight to be applied to the amount of dedicated disk space required per task by a job (in MB)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESWEIGHT 10</pre></div> <div class="example">DISKWEIGHT 100</pre></div> <p>(if a job requires 12 tasks and 512 MB per task of dedicated local disk space, Maui will increase the job's priority by 10 * 100 * 12 * 512)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="displayflags"></a> <b>DISPLAYFLAGS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more of the following values (space delimited) <p>NODECENTRIC</p></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies flags which control how maui client commands will display various information</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DISPLAYFLAGS NODECENTRIC</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="downnodedelaytime"></a> <b>DOWNNODEDELAYTIME*</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">24:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">default time an unavailable node (Down or Drain) is marked unavailable</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>DOWNNODEDELAYTIME 1:00:00</pre></div> <p>(Maui will assume 'down' nodes will be available 1 hour after they go down unless a system reservation is placed on the node)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="enablemultinodejobs"></a><b>ENABLEMULTINODEJOBS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><BOOLEAN> </td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">TRUE</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether or not the scheduler will allow jobs to span more than one node </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ENABLEMULTINODEJOBS FALSE</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="enablemultireqjobs"></a><b>ENABLEMULTIREQJOBS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><BOOLEAN> </td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">FALSE</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether or not the scheduler will allow jobs to specify multiple independent resource requests (i.e., pbs jobs with resource specifications such as '-l nodes=3:fast+1:io') </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ENABLEMULTIREQJOBS TRUE</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="enablenegjobpriority"></a><b>ENABLENEGJOBPRIORITY[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><BOOLEAN> </td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">FALSE </td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">if set to TRUE, the scheduler will allow job priority value to range from -INFINITY to MMAX_PRIO, otherwise, job priority values are given a lower bound of '1'. (see <a href="#rejectnegpriojobs">REJECTNEGPRIOJOBS</a>) </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>ENABLENEGJOBPRIORITY TRUE</pre></div> <p>(Job priority may range from -INFINITY to MMAX_PRIO.) </p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="featurenodetypeheader"></a> <b>FEATURENODETYPEHEADER</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the header used to specify node type via node features (ie, LL features or PBS node attributes).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FEATURENODETYPEHEADER xnt</pre></div> <p>(Maui will interpret all node features with the leading string <tt> xnt</tt> as a nodetype specification - as used by QBank and other allocation managers, and assign the associated value to the node. i.e., xntFast)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="featurepartitionheader"></a> <b>FEATUREPARTITIONHEADER</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the header used to specify node partition via node features (ie, LL features or PBS node attributes).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FEATUREPARTITIONHEADER xpt</pre></div> <p>(Maui will interpret all node features with the leading string <tt> xpt</tt> as a partition specification and assign the associated value to the node. i.e., xptGold)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="featureprocspeedheader"></a> <b>FEATUREPROCSPEEDHEADER</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the header used to extract node processor speed via node features (i.e., LL features or PBS node attributes). NOTE: Adding a trailing '$' character will specifies that only features with a trailing number be interpreted. For example, the header 'sp$' will match 'sp450' but not 'sport'</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FEATUREPROCSPEEDHEADER xps</pre></div> <p>(Maui will interpret all node features with the leading string <tt> xps</tt> as a processor speed specification and assign the associated value to the node. i.e., xps950)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="feedbackprogram"></a> <b>FEEDBACKPROGRAM</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the name of the program to be run at the completion of each job. If not fully qualified, Maui will attempt to locate this program in the 'tools' subdirectory.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FEEDBACKPROGRAM /var/maui/fb.pl</pre></div> <p>(Maui will run the specified program at the completion of each job.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsaccountweight"></a> <b>FSACCOUNTWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight assigned to the account subcomponent of the fairshare component of priority</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSACCOUNTWEIGHT 10</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fscap"></a> <b>FSCAP</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (NO CAP)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum allowed value for a job's total pre-weighted fairshare component</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSCAP 10.0</pre></div> <p>(Maui will not allow a job's pre-weighted fairshare component to exceed 10.0, <div class="example"> ie, Priority = FSWEIGHT * MIN(FSCAP,FSFACTOR) + ...)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsconfigfile"></a> <b>FSCONFIGFILE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">fs.cfg</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsdecay"></a> <b>FSDECAY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1.0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsdepth"></a> <b>FSDEPTH</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">7</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">NOTE: The number of available fairshare windows is bounded by the <b>MAX_FSDEPTH</b> value (24 in Maui 3.2.6 and earlier, 32 in Maui 3.2.7 and later) </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSDEPTH 12</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsgroupweight"></a> <b>FSGROUPWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSGROUPWEIGHT 4</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsinterval"></a> <b>FSINTERVAL</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">24:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the length of each fairshare '<a href="6.3fairshare.php"> window</a> '</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSINTERVAL 12:00:00</pre></div> <div class="example"> (track fairshare usage in 12 hour blocks)</td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fspolicy"></a> <b>FSPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>DEDICATEDPS</b>, <b>DEDICATEDPES</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the unit of tracking fairshare usage. <b>DEDICATEDPS</b> tracks dedicated processor seconds. <b>DEDICATEDPES</b> tracks dedicated processor-equivalent seconds</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSPOLICY DEDICATEDPES</pre></div> <p>(Maui will track fairshare usage by dedicated process-equivalent seconds)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsqosweight"></a> <b>FSQOSWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight assigned to the QOS fairshare subcomponent</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsuserweight"></a> <b>FSUSERWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight assigned to the user fairshare subfactor.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSUSERWEIGHT 8</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="fsweight"></a> <b>FSWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight assigned to the summation of the fairshare subfactors</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>FSWEIGHT 500</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="groupcfg"></a> <b>GROUPCFG[<GROUPID>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <br> <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QLIST</b>, <b>QDEF</b>, <b>PLIST</b> , <b>PDEF</b>, <b>FLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies group specific attributes. See the <a href="jobflagoverview.php"> flag overview</a> for a description of legal flag values. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>GROUPCFG[staff] MAXJOB=50 QDEF=highprio</pre></div> <p>(up to 50 jobs submitted by members of the group <tt>staff</tt> will be allowed to execute simultaneously and will be assigned the QOS <tt> highprio</tt> by default.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="groupweight"></a><b>GROUPWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight assigned to the specified group priority (See <a href="5.1.2priorityfactors.php#cred">Cred Factor</a>)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>GROUPWEIGHT 20</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobaggregationtime"></a><b>JOBAGGREGATIONTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum amount of time the scheduler should wait after receiving a job event until it should process that event. This parameter allows sites with <i>bursty</i> job submissions to process job events in groups decreasing total job scheduling cycles and allowing the scheduler to make more intelligent choices by aggregating job submissions and choosing between the jobs. (See <a href="a.ilargeclusters.php">Considerations for Large Clusters</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBAGGREGATIONTIME 00:00:04</pre></div> <div class="example"> <pre>RMPOLLINTERVAL 00:00:30</pre></div> <p>The scheduler will wait 4 seconds between scheduling cycles when job events have been received and will wait 30 seconds between scheduling cycles otherwise</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobmaxstarttime"></a><b>JOBMAXSTARTTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (NO LIMIT)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">length of time a job is allowed to remain in a 'starting' state. If a 'started' job does not transition to a running state within this amount of time, the scheduler will cancel the job, believing a system failure has occurred.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBMAXSTARTTIME 2:00:00</pre></div> <p>(jobs may attempt to start for up to 2 hours before being cancelled by the scheduler)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobmaxoverrun"></a> <b>JOBMAXOVERRUN</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">amount of time Maui will allow a job to exceed its wallclock limit before it is terminated</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBMAXOVERRUN 1:00:00</pre></div> <p>(allow jobs to exceed their wallclock limit by up to 1 hour)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobnodematchpolicy"></a> <b>JOBNODEMATCHPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">zero or more of the following: <b>EXACTNODE</b> or <b>EXACTPROC</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies additional constraints on how compute nodes are to be selected. <b>EXACTNODE</b> indicates that Maui should select as many nodes as requested even if it could pack multiple tasks onto the same node. <b>EXACTPROC</b> indicates that Maui should select only nodes with exactly the number of processors configured as are requested per node even if nodes with excess processors are available.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBNODEMATCHPOLICY EXACTNODE</pre></div> <p>(In a PBS job with resource specification 'nodes=<x>:ppn=<y>', Maui will allocate exactly <y> task on each of <x> distinct nodes.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobprioaccrualpolicy"></a> <b>JOBPRIOACCRUALPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>ALWAYS</b>, <b>FULLPOLICY</b>, <b>QUEUEPOLICY</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>QUEUEPOLICY</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how the dynamic aspects of a job's priority will be adjusted. <b>ALWAYS</b> indicates that the job will accrue queuetime based priority from the time it is submitted. <b>FULLPOLICY</b> indicates that it will accrue priority only when it meets all queue AND run policies. <b>QUEUEPOLICY</b> indicates that it will accrue priority so long as it satisfies various queue policies, i.e. MAXJOBQUEUED.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBPRIOACCRUALPOLICY QUEUEPOLICY</pre></div> <p>(Maui will adjust the job's dynamic priority subcomponents, i.e., QUEUETIME, XFACTOR, and TARGETQUEUETIME, etc. each iteration that the job satisfies the associated 'QUEUE' policies such as MAXJOBQUEUED.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobsizepolicy"></a> <b>JOBSIZEPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><N/A></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"><N/A></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"><N/A></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="jobsynctime"></a> <b>JOBSYNCTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]:SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:10:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the length of time after which Maui will sync up a job's expected state with an unexpected reported state. IMPORTANT NOTE: Maui will not allow a job to run as long as its expected state does not match the state reported by the resource manager. NOTE: this parameter is named JOBSYNCDEADLINE in Maui 3.0.5 and earlier</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>JOBSYNCTIME 00:01:00</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="logdir"></a> <b>LOGDIR</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">log</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the directory in which log files will be maintained. If specified as a relative path, LOGDIR will be relative to $(MAUIHOMEDIR) (see <a href="14.2logging.php">Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGDIR /tmp</pre></div> <p>(Maui will record its log files directly into the <tt>/tmp</tt> directory)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="logfacility"></a> <b>LOGFACILITY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">colon delimited list of one or more of the following: <b> fCORE</b>, <b>fSCHED</b>, <b>fSOCK</b>, <b>fUI</b>, <b>fLL</b>, <b>fSDR</b> , <b>fCONFIG</b>, <b>fSTAT</b>, <b>fSIM</b>, <b>fSTRUCT</b>, <b>fFS</b>, <b> fCKPT</b>, <b>fBANK</b>, <b>fRM</b>, <b>fPBS</b>, <b>fWIKI</b>, <b>fALL</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>fALL</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies which types of events to log (see <a href="14.2logging.php"> Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGFACILITY fRM:fPBS</pre></div> <p>(Maui will log only events involving general resource manager or PBS interface activities.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="logfile"></a> <b>LOGFILE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">maui.log</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">name of the maui log file. This file is maintained in the directory pointed to by <LOGDIR> unless <LOGFILE> is an absolute path (see <a href="14.2logging.php">Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGFILE maui.test.log</pre></div> <p>(Log information will be written to the file <tt>maui.test.log</tt> located in the directory pointed to by the <a href="#logdir">LOGDIR</a> parameter)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="logfilemaxsize"></a> <b>LOGFILEMAXSIZE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">10000000</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed size (in bytes) the log file before it will be 'rolled' (see <a href="14.2logging.php">Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGFILEMAXSIZE 50000000</pre></div> <p>(Log files will be rolled when they reach 50 MB in size)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="logfilerolldepth"></a> <b>LOGFILEROLLDEPTH</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">2</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">number of old log files to maintain (i.e., when full, maui.log will be renamed maui.log.1, maui.log.1 will be renamed maui.log.2, ... (see <a href="14.2logging.php"> Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGFILEROLLDEPTH 5</pre></div> <p>(Maui will maintain the last 5 log files.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="loglevel"></a> <b>LOGLEVEL</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER> (0-9)</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the verbosity of Maui logging where 9 is the most verbose (NOTE: each logging level is approximately an order of magnitude more verbose than the previous level) (see <a href="14.2logging.php">Logging Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>LOGLEVEL 4</pre></div> <p>(Maui will write all Maui log messages with a threshold of 4 or lower to the 'maui.log' file)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxjobperuser"></a> <b>MAXJOBPERUSERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum number of active jobs allowed at any given time. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxjobqueuedperuser"></a> <b>MAXJOBQUEUEDPERUSERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum number of idle jobs which can be considered for scheduling and which can acquire 'system queue time' for increasing job priority. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxnodeperuser"></a> <b>MAXNODEPERUSERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed total PE count which can be dedicated at any given time. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxpeperuser"></a> <b>MAXPEPERUSERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed total PE count which can be dedicated at any given time. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxprocperuser"></a> <b>MAXPROCPERUSERCOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed total processors which can be dedicated at any give time. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxprocsecondperuser"></a> <b>MAXPSPERUSER</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER>[,<INTEGER>]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed sum of outstanding dedicated processor-second obligations of all active jobs. (NOTE: This parameter is deprecated, see <a href="policynote-3.0.php">note</a>).</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="maxwcperuser"></a> <b>MAXWCPERUSER</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS[,[[[DD:]HH:]MM:]SS]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (No Limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">maximum allowed sum of outstanding walltime limits of all active jobs. NOTE: only available in Maui 3.2 and higher.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="memweight"></a> <b>MEMWEIGHT</b>[X]</td> </tr> <tr> <td class="contentLabels bottomRow">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the coefficient to be multiplied by a job's MEM (dedicated memory in MB) factor</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESWEIGHT[0] 10</pre></div> <div class="example"><pre>MEMWEIGHT[0] 1000</pre></div> <p>(each job's priority will be increased by 10 * 1000 * its MEM factor)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodeaccesspolicy"></a> <b>NODEACCESSPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following:<b>SHARED</b>, <b>SINGLEJOB</b>, <b>SINGLETASK</b> , or <b>SINGLEUSER</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>SHARED</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how node resources will be shared by various tasks (See the '<a href="5.3nodeaccess.php">Node Access Overview</a> ' for more information)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEACCESSPOLICY SINGLEUSER</pre></div> <p>(Maui will allow resources on a node to be used by more than one job provided that the job's are all owned by the same user)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodeallocationpolicy"></a> <b>NODEALLOCATIONPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>FIRSTAVAILABLE</b>, <b>LASTAVAILABLE</b>, <b>MINRESOURCE</b>, <b>CPULOAD</b>, <b>PRIORITY, LOCAL, CONTIGUOUS, MAXBALANCE, or FASTEST</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>LASTAVAILABLE</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how Maui should allocate available resources to jobs. (See the <a href="5.2nodeallocation.php">Node Allocation</a> section of the Admin manual for more information)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEALLOCATIONPOLICY MINRESOURCE</pre></div> <p>(Maui will apply the node allocation policy 'MINRESOURCE' to all jobs by default)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodeavailabilitypolicy"></a> <b>NODEAVAILABILITYPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><POLICY>[:<RESOURCETPYE>] ... <p>where <POLICY> is one of <b>COMBINED</b>, <b>DEDICATED</b>, or <b>UTILIZED</b> and <RESOURCETYPE> is one of <b>PROC</b>, <b>MEM</b>, <b>SWAP</b>, or <b>DISK</b></p></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>COMBINED</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how Maui will evaluate node availability on a per resource basis. (See the <a href="5.4nodeavailability.php">Node Availability</a> section of the Admin manual for more information)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEAVAILABILITYPOLICY DEDICATED:PROCS COMBINED:MEM</pre></div> <p>(Maui will ignore resource utilization information in locating available processors for jobs but will use both dedicated and utilized memory information in determining memory availability)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodecfg"></a> <b>NODECFG[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <b>ACCESS, MAXJOB</b>, <b>MAXJOBPERUSER</b>, <b>MAXLOAD</b>, <b>FRAME</b> , <b>SLOT</b>, <b>SPEED</b>, <b>PROCSPEED</b>, <b>PARTITION</b>, <b>NODETYPE</b> , <b>FEATURES</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies node-specific attributes for the node indicated in the array field. See the <a href="5.2nodeallocation.php">Node Configuration Overview</a> for more information. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODECFG[nodeA] MAXJOB=2 SPEED=1.2</pre></div> <p>(Maui will only only two simultaneous jobs to run on node '<tt>nodeA</tt> ' and will assign a relative machine speed of 1.2 to this node.)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodedownstatedelaytime"></a> <b>NODEDOWNSTATEDELAYTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">length of time Maui will assume down, drained (offline), or corrupt nodes will remain unavailable for scheduling if a system reservation is not explicitly created for the node. <b>NOTE</b>: This parameter is enabled in Maui 3.0.7 and higher.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEDOWNSTATEDELAYTIME 0:30:00</pre></div> <p>(Maui will assume down, drained, and corrupt nodes are not available for scheduling for at least 30 minutes from the current time. Thus, these nodes will never be allocated to starting jobs. Also, these nodes will only be available for reservations starting more than 30 minutes in the future.)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodeloadpolicy"></a> <b>NODELOADPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>ADJUSTSTATE</b> or <b>ADJUSTPROCS</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>ADJUSTSTATE</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies if a node's load affects its state or its available processors. ADJUSTSTATE tells Maui to mark the node busy when MAXLOAD is reached. ADJUSTPROCS causes the node's available procs to be equivalent to MIN(ConfiguredProcs - DedicatedProcs,MaxLoad - CurrentLoad) NOTE: NODELOADPOLICY only affects a node if MAXLOAD has been set.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODELOADPOLICY ADJUSTSTATE</pre></div> <p>(Maui will mark a node busy if its measured load exceeds its MAXLOAD setting)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodemaxload"></a> <b>NODEMAXLOAD</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0.0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies that maximum load on a idle of running node. If the node's load reaches or exceeds this value, Maui will mark the node 'busy'</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEMAXLOAD 0.75</pre></div> <p>(Maui will adjust the state of all Idle and Running nodes with a load >= .75 to the state 'Busy')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodepollfrequency"></a> <b>NODEPOLLFREQUENCY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (Poll Always)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number of scheduling iterations between scheduler initiated node manager queries.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEPOLLFREQUENCY 5</pre></div> <p>(Maui will update node manager based information every 5 scheduling iterations)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesetattribute"></a> <b>NODESETATTRIBUTE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>FEATURE</b>, <b>MEMORY</b>, or <b>PROCSPEED</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the type of node attribute by which node set boundaries will be established. <b>NOTE</b>: enabled in Maui 3.0.7 and higher. (See <a href="8.3nodesetoverview.php">Node Set Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETATTRIBUTE PROCSPEED</pre></div> <p>(Maui will create node sets containing nodes with common processor speeds)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesetdelay"></a> <b>NODESETDELAY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the length of time Maui will delay a job if adequate idle resources are available but not adequate resources within node set constraints. <b>NOTE</b>: in Maui 3.2 and higher, setting NODESETDELAY to any non-zero value will force Maui to always use nodesets. A value of zero will cause Maui to use nodesets on a best effort basis. (See <a href="8.3nodesetoverview.php">Node Set Overview</a>)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETDELAY 0:00:00</pre></div> <p>(Maui will create node sets containing nodes with common processor speeds)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesetlist"></a> <b>NODESETLIST</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the list of node attribute values which will be considered for establishing node sets. <b>NOTE</b>: enabled in Maui 3.0.7 and higher. (See <a href="8.3nodesetoverview.php">Node Set Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETPOLICY ONEOF</pre></div> <div class="example"> <pre>NODESETATTRIBUTE FEATURE</pre></div> <div class="example"> <pre>NODESETLIST switchA switchB</pre></div> <p>(Maui will allocate nodes to jobs either using only nodes with the 'switchA' feature or using only nodes with the 'switchB' feature.)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesetpolicy"></a> <b>NODESETPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>ONEOF</b>, <b>FIRSTOF</b>, or <b>ANYOF</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how nodes will be allocated to the job from the various node set generated. <b>NOTE</b>: enabled in Maui 3.0.7 and higher. (See <a href="8.3nodesetoverview.php">Node Set Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETPOLICY ONEOF</pre></div> <div class="example"> <pre>NODESETATTRIBUTE NETWORK</pre></div> <p>(Maui will create node sets containing nodes with common network interfaces)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesetprioritytype"></a> <b>NODESETPRIORITYTYPE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>BESTFIT</b>, <b>WORSTFIT</b>, <b>BESTRESOURCE</b>, or <b> MINLOSS</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">MINLOSS</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how resource sets will be selected when more than one feasible resource can can be found. <b>NOTE</b>: This parameter is available in Maui 3.0.7 and higher. (See <a href="8.3nodesetoverview.php"> Node Set Overview</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETPRIORITYTYPE BESTRESOURCE</pre></div> <div class="example"> <pre>NODESETATTRIBUTE PROCSPEED</pre></div> <p>(Maui will select the resource set containing the fastest nodes available)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesettolerance"></a> <b>NODESETTOLERANCE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><FLOAT></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0.0 (Exact match only)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the tolerance for selection of mixed processor speed nodes. A tolerance of <b>X</b> allows a range of processors to be selected subject to the constraint <p>(Speed.Max - Speed.Min) / Speed.Min <= X </p> <p><b>NOTE</b>: Tolerances are only applicable when NODESETFEATURE is set to PROCSPEED. This parameter is available in Maui 3.0.7 and higher.<br /> (See <a href="8.3nodesetoverview.php">Node Set Overview</a> )</p></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESETATTRIBUTE PROCSPEED</pre></div> <div class="example"> <pre>NODESETTOLERANCE 0.5</pre></div> <p>(Maui will only allocate nodes with up to a 50% procspeed difference.)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodesynctime"></a> <b>NODESYNCTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:10:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the length of time after which Maui will sync up a node's expected state with an unexpected reported state. IMPORTANT NOTE: Maui will not start new jobs on a node with an expected state which does not match the state reported by the resource manager. NOTE: this parameter is named <b>NODESYNCDEADLINE</b> in Maui 3.0.5 and earlier.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODESYNCTIME 1:00:00</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="nodeweight"></a><b>NODEWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight which will be applied to a job's requested node count before this value is added to the job's cumulative priority. <b>NOTE</b> : this weight currently only applies when a nodecount is specified by the user job. If the job only specifies tasks or processors, no node factor will be applied to the job's total priority. (This will be rectified in future versions.)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NODEWEIGHT 1000</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="notificationprogram"></a> <b>NOTIFICATIONPROGRAM</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the name of the program to handle all notification call-outs</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>NOTIFICATIONPROGRAM tools/notifyme.pl</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="peweight"></a> <b>PEWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the coefficient to be multiplied by a job's PE (processor equivalent) priority factor</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESWEIGHT[0] 10</pre></div> <div class="example"> <pre>PEWEIGHT[0] 100</pre></div> <p>(each job's priority will be increased by 10 * 100 * its PE factor)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plotmaxproc"></a> <b>PLOTMAXPROC</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">512</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum number of processors requested by jobs to be displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php">showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINPROC 1</pre></div> <div class="example"> <pre>PLOTMAXPROC 1024</pre></div> <p>(each matrix output will display data in rows for jobs requesting between 1 and 1024 processors)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plotmaxtime"></a> <b>PLOTMAXTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">68:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum duration of jobs to be displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php">showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINTIME 1:00:00</pre></div> <div class="example"> <pre>PLOTMAXTIME 64:00:00</pre></div> <p>(each matrix output will display data in columns for jobs requesting between 1 and 64 hours of run time)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plotminproc"></a> <b>PLOTMINPROC</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum number of processors requested by jobs to be displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php">showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINPROC 1</pre></div> <div class="example"> <pre>PLOTMAXPROC 1024</pre></div> <p>(each matrix output will display data in rows for jobs requesting between 1 and 1024 processors)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plotmintime"></a> <b>PLOTMINTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:02:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum duration of jobs to be displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php">showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINTIME 1:00:00</pre></div> <div class="example"> <pre>PLOTMAXTIME 64:00:00</pre></div> <p>(each matrix output will display data in columns for jobs requesting between 1 and 64 hours of run time)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plotprocscale"></a> <b>PLOTPROCSCALE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">9</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number of rows into which the range of processors requested per job will be divided when displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php">showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINPROC 1</pre></div> <div class="example"> <pre>PLOTMAXPROC 1024</pre></div> <div class="example"> <pre>PLOTPROCSCALE 10</pre></div> <p>(each matrix output will display job data divided into 10 rows which are evenly spaced geometrically covering the range of jobs requesting between 1 and 1024 processors)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="plottimescale"></a> <b>PLOTTIMESCALE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">11</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number of columns into which the range of job durations will be divided when displayed in matrix outputs (as displayed by the <a href="commands/showgrid.php"> showgrid</a> or <a href="commands/profiler.php">profiler</a> commands)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PLOTMINTIME 2:00:00</pre></div> <div class="example"> <pre>PLOTMAXTIME 32:00:00</pre></div> <div class="example"> <pre>PLOTTIMESCALE 5</pre></div> <p>(each matrix output will display job data divided into 5 columns which are evenly spaced geometrically covering the range of jobs requesting between 2 and 32 hours, i.e., display columns for 2, 4, 8, 16, and 32 hours of walltime)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="preemptpolicy"></a> <b>PREEMPTPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <br /> <b>REQUEUE</b>, <b>SUSPEND</b>, <b>CHECKPOINT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><b>REQUEUE</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how preemptible jobs will be preempted (Available in Maui 3.2.2 and higher)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PREEMPTPOLICY CHECKPOINT</pre></div> <p>(jobs that are to be preempted will be checkpointed and restarted at a later time)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="procweight"></a> <b>PROCWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the coefficient to be multiplied by a job's requested processor count priority factor</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PROCWEIGHT 2500</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="purgetime"></a> <b>PURGETIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">The amount of time Maui will keep a job or node record for an object no longer reported by the resource manager. Useful when using a resource manager which 'drops' information about a node or job due to internal failures.<b> NOTE</b>: In Maui 3.2.0 an higher, this parameter is superseded by <b>JOBPURGETIME</b> and <b>NODEPURGETIME</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>PURGETIME 00:05:00</pre></div> <p>(Maui will maintain a job or node record for 5 minutes after the last update regarding that object received from the resource manager.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qoscfg"></a><b>QOSCFG[<QOSID>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QTWEIGHT</b>, <b>QTTARGET</b>, <b>XFWEIGHT</b>, <b>XFTARGET</b>, <b>PLIST</b>, <b>PDEF</b>, <b>QFLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies QOS specific attributes. See the <a href="jobflagoverview.php">flag overview</a> for a description of legal flag values. <b>NOTE:</b> Available in Maui 3.0.6 and higher. <b>QOSCFG</b> supersedes <b>QOSNAME</b>, <b>QOSPRIORITY</b>, <b>QOSFLAGS</b>, and other '<b>QOS*</b>' parameters.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSCFG[commercial] PRIORITY=1000 MAXJOB=4 MAXPROCS=80</pre></div> <p>(The scheduler will increase the priority of jobs using QOS commercial, and will allow up to 4 simultaneous QOS commercial jobs with up to 80 total allocated processors.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosfeatures"></a> <b>QOSFEATURES[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more node feature values or [ANY]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[ANY]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies which node features must be present on resources allocated to jobs of the associated QOS. This parameter takes a QOS name as an array index.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSFEATURES[2] wide interactive</pre></div> <p>(jobs with a QOS value of 2 may only run on nodes with the feature 'wide' AND the feature 'interactive' set)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosflags"></a> <b>QOSFLAGS[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more of the following (space delimited) <br /> IGNJOBPERUSER, IGNPROCPERUSER, IGNNODEPERUSER, IGNPSPERUSER, IGNJOBQUEUEDPERUSER, IGNJOBPERGROUP, IGNPROCPERGROUP, IGNPSPERGROUP, IGNJOBQUEUEDPERGROUP, IGNJOBPERACCOUNT, IGNPROCPERACCOUNT, IGNPSPERACCOUNT, IGNJOBQUEUEDPERACCOUNT, IGNSYSMAXPROC, IGNSYSMAXTIME, IGNSYSMAXPS, IGNSRMAXTIME, IGNUSER, IGNGROUP, IGNACCOUNT, IGNSYSTEM, IGNALL, PREEMPT, DEDICATED, RESERVEALWAYS, USERESERVED, NOBF, NORESERVATION, RESTARTPREEMPT</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the attributes of the corresponding QOS value See the Admin Manual <a href="7.3qos.php">QOS Overview</a> section for details (NOTE: some flags are only supported under Maui 3.1 and later)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSFLAGS[1] ADVRES IGNMAXJOBPERUSER</pre></div> <p>(jobs with a QOS value of 1 must run in an advance reservation and can ignore the MAXJOBPERUSER policy)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qospriority"></a> <b>QOSPRIORITY[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority associated with this QOS (NOTE: only used in Maui 3.0.x)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSPRIORITY[2] 1000</pre></div> <p>(set the priority of QOS 2 to 1000)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosqttarget"></a> <b>QOSQTTARGET[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the target job queuetime associated with this QOS</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSQTTARGET 2:00:00</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosqtweight"></a> <b>QOSQTWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the 'per QOS' queue time priority weight</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSQTWEIGHT 5</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosxftarget"></a> <b>QOSXFTARGET[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the expansion factor target used in a job's 'Target Factor' priority calculation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QOSWEIGHT[3] 10</pre></div> <div class="example"> <pre>QOSXFTARGET[3] 5.0</pre></div> <p>(jobs requesting a QOS of 3 will have their priority grow exponentially as the job's minimum expansion factor approaches 5.0)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="qosxfweight"></a> <b>QOSXFWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight which will be added to the base XFWEIGHT for all jobs using QOS 'X'</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>XFACTORWEIGHT[0] 100</pre></div> <div class="example"> <pre>QOSXFWEIGHT[2] 1000</pre></div> <p>(jobs using QOS '2' will have an effective XFACTORWEIGHT of 1100 while jobs using other QOS's will have an XFACTORWEIGHT of 100)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="queuetimecap"></a> <b>QUEUETIMECAP[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (NO CAP)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum allowed pre-weighted queuetime priority factor.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QUEUETIMECAP[0] 10000</pre></div> <div class="example"> <pre>QUEUETIMEWEIGHT[0] 10</pre></div> <p>(a job that has been queued for 40 minutes will have its queuetime priority factor calculated as 'Priority = QUEUETIMEWEIGHT * MIN(10000,40)')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="queuetimeweight"></a> <b>QUEUETIMEWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies multiplier applied to a job's queue time (in minutes) to determine the job's queuetime priority factor</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>QUEUETIMEWEIGHT[0] 20</pre></div> <p>(a job that has been queued for 4:20:00 will have a queuetime priority factor of 20 * 260)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rejectnegpriojobs"></a><b>REJECTNEGPRIOJOBS[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><BOOLEAN> </td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">TRUE </td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">if enabled, the scheduler will refuse to start any job with a negative priority. (see <a href="#enablenegjobpriority">ENABLENEGJOBPRIORITY</a>) </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"><div class="example"><pre> ENABLENEGJOBPRIORITY TRUE REJECTNEGPRIOJOBS TRUE</pre></div> <p>(Any job with a priority less than 0 will be rejected) </p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="resctlpolicy"></a> <b>RESCTLPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <br /> <b>ADMINONLY</b>, <b>ANY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><b>ADMINONLY</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies who can create admin reservations (Available in Maui 3.2 and higher)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESCTLPOLICY ANY</pre></div> <p>(any valid user can create an arbitrary admin reservation)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="resdepth"></a> <b>RESDEPTH</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">24</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum number of reservations which can be on any single node. IMPORTANT NOTE: on large way SMP systems, this value often must be increased. To be on the safe side, this value should be approximately twice the average sum of admin, standing, and job reservations present.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESDEPTH 64</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="reservationdepth"></a> <b>RESERVATIONDEPTH[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">1</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how many priority reservations are allowed in the associated reservation stack</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESERVATIONDEPTH[0] 4</pre></div> <div class="example"> <pre>RESERVATIONQOSLIST[0] 1 3 5</pre></div> <p>(jobs with QOS values of 1, 3, or 5 can have a cumulative total of up to 4 priority reservations)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="reservationpolicy"></a> <b>RESERVATIONPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>CURRENTHIGHEST</b>, <b>HIGHEST</b>, <b>NEVER</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>CURRENTHIGHEST</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how Maui reservations will be handled. (See also <a href="#reservationdepth"> RESERVATIONDEPTH</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESERVATIONPOLICY CURRENTHIGHEST</pre></div> <div class="example"> <pre>RESERVATIONDEPTH 2</pre></div> <p>(Maui will maintain reservations for only the two currently highest priority jobs)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="reservationqoslist"></a> <b>RESERVATIONQOSLIST[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more QOS values or [ALL]</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[ALL]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies which QOS levels have access to the associated reservation stack</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESERVATIONDEPTH[0] 4</pre></div> <div class="example"> <pre>RESERVATIONQOSLIST[0] 1 3 5</pre></div> <p>(jobs with QOS values of 1, 3, or 5 can have a cumulative total of up to 4 priority reservations)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="reservationretrytime"></a> <b>RESERVATIONRETRYTIME[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">Period of time Maui will continue to attempt to start a job in a reservation when job start failures are detected due to resource manager corruption</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="resourcecap"></a> <b>RESCAP[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (NO CAP)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum allowed pre-weighted job resource priority factor</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESCAP[0] 1000</pre></div> <p>(The total resource priority factor component of a job's priority will not be allowed to exceed 1000, i.e., 'Priority = RESWEIGHT * MIN(RESCAP,<RESOURCEFACTOR>) + ...)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="resourcelimitpolicy"></a> <b>RESOURCELIMITPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><RESOURCE>:<POLICY>:<ACTION> [:<VIOLATIONTIME>]... <p>where <b>RESOURCE</b> is one of <b>PROC</b>, <b>DISK</b>, <b>SWAP</b>, or <b>MEM</b>, where <b>POLICY</b> is one of <b>ALWAYS</b> or <b>EXTENDEDVIOLATION</b> <!--, or <b>BLOCKEDWORKLOADONLY</b> --> and where <b>ACTION</b> is one of <b>CANCEL</b>, <b>REQUEUE</b>, or <b>SUSPEND</b></p></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">no limit enforcement</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how the scheduler should handle jobs which utilize more resources than they request. <b>NOTE</b>: Only available in Maui 3.2 and higher.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre><font size="-2">RESOURCELIMITPOLICY MEM:ALWAYS:CANCEL</font></pre></div> <p>(Maui will cancel all jobs which exceed their requested memory limits.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="resourceweight"></a> <b>RESWEIGHT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">all resource priority components are multiplied by this value before being added to the total job priority.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RESWEIGHT[0] 5</pre></div> <div class="example"> <pre>MEMORYWEIGHT[0] 10</pre></div> <div class="example"> <pre>PROCWEIGHT[0] 100</pre></div> <div class="example"> <pre>SWAPWEIGHT[0] 0</pre></div> <div class="example"> <pre>RESCAP[0] 2000</pre></div> <p>(the job priority resource factor will be calculated as MIN(2000,5 * (10 * JobMemory + 100 * JobProc)))</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmauthtype"></a> <b>RMAUTHTYPE[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>CHECKSUM</b>, <b>PKI</b>, or <b>SECUREPORT</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>CHECKSUM</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies the security protocol to be used in scheduler-resource manager communication. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMAUTHTYPE[0] CHECKSUM</pre></div> <p>(The scheduler will require a secure checksum associated with each resource manager message)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmcfg"></a> <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more <b>key-value</b> pairs as described in the <a href="13.2rmconfiguration.php">Resource Manager Configuration Overview</a></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">N/A</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the interface and policy configuration for the scheduler-resource manager interface. Described in detail in the <a href="13.2rmconfiguration.php">Resource Manager Configuration Overview</a></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMCFG[bank] TYPE=PBS </pre></div> <p>(the PBS server will be used for resource management)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmnmport"></a> <b>RMNMPORT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">(any valid port number)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies a non-default RM node manager through which extended node attribute information may be obtained. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMNMPORT[0] 13001</pre></div> <p>(Maui will contact the node manager located on each compute node at port 13001)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmpollinterval"></a> <b>RMPOLLINTERVAL</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:01:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies interval between RM polls</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMPOLLINTERVAL 60</pre></div> <p>(Maui will refresh its resource manager information every 60 seconds. NOTE: this parameter specifies the global poll interval for all resource managers)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmport"></a> <b>RMPORT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the port on which Maui should contact the associated resource manager. The value '0' specifies to use the appropriate default port for the resource manager type selected. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMTYPE[0] PBS</pre></div> <div class="example"> <pre>RMHOST[0] cws</pre></div> <div class="example"> <pre>RMPORT[0] 20001</pre></div> <p>(Maui will attempt to contact the PBS server daemon on host cws, port 20001)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmserver"></a> <b>RMSERVER[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><HOSTNAME></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the host on which Maui should contact the associated resource manager. An empty value specifies to use the default hostname for the resource manager selected. NOTE: this parameter is renamed <b> RMHOST</b> in Maui 3.0.6 and higher. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMTYPE[0] LL2</pre></div> <div class="example"> <pre>RMHOST[0]</pre></div> <div class="example"> <pre>RMPORT[0] 0</pre></div> <p>(Maui will attempt to contact the Loadleveler version 2 Negotiator daemon on the default host and port, as specified in the LL config files)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmtimeout"></a> <b>RMTIMEOUT[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">15</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">seconds maui will wait for a response from the associated resource manager. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMTIMEOUT[1] 30</pre></div> <p>(The scheduler will wait 30 seconds to receive a response from resource manager '1' before timing out and giving up. The scheduler will try again on the next iteration.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="rmtype"></a> <b>RMTYPE[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><RMTYPE>[:<RMSUBTYPE>] where <RMTYPE is one of the following: <b>LL</b>, <b>PBS</b>, or <b>WIKI</b> and <RMSUBTYPE> is one of <b>RMS</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">LL</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies type of resource manager to be contacted by Maui. NOTE: for <b>RMTYPE</b> <b>WIKI</b>, <b>RMAUTHTYPE</b> must be set to <b>CHECKSUM</b>. NOTE: deprecated in Maui 3.2 - use <b>RMCFG</b>. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>RMTYPE[0] PBS</pre></div> <div class="example"> <pre>RMHOST[0] cluster1</pre></div> <div class="example"> <pre>RMPORT[0] 15003</pre></div> <div class="example"> <pre>RMTYPE[1] PBS</pre></div> <div class="example"> <pre>RMHOST[1] cluster2</pre></div> <div class="example"> <pre>RMPORT[1] 15004</pre></div> <p>(Maui will interface to two different PBS resource managers, one located on server cluster1 at port 15003 and one located on server cluster2 at port 15004)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="serverhost"></a> <b>SERVERHOST</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><HOSTNAME></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">hostname of machine on which maui will run. NOTE: this parameter MUST be specified.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SERVERHOST geronimo.scc.edu</pre></div> <p>(Maui will execute on the host <tt>geronimo.scc.edu</tt>)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="servermode"></a> <b>SERVERMODE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <br /> <b>NORMAL</b>, <b>TEST</b>, or <b>SIMULATION</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">NORMAL</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how Maui interacts with the outside world. See <Testing> for more information</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SERVERMODE SIMULATION</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="servername"></a> <b>SERVERNAME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><SERVERHOST></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SERVERNAME mauiA</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="serverport"></a> <b>SERVERPORT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER> (range: 1-64000)</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">40559</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">port on which maui will open its user interface socket</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SERVERPORT 30003</pre></div> <p>(Maui will listen for client socket connections on port 30003)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simautoshutdown"></a> <b>SIMAUTOSHUTDOWN</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><BOOLEAN></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>TRUE</b></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">if TRUE, the scheduler will end simulations when the active queue and idle queue become empty</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMAUTOSHUTDOWN ON</pre></div> <p>(The scheduler simulation will end as soon as there are no jobs running and no idle jobs which could run)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simcpuscalingpercent"></a> <b>SIMCPUSCALINGPERCENT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">100 (no scaling)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether to increase or decrease the runtime and wallclock limit of each job in the workload trace file.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simdefaultjobflags"></a> <b>SIMDEFAULTJOBFLAGS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">zero or more of the following: <br /> <b>ADVRES</b>, <b>HOSTLIST</b>, <b>RESTARTABLE</b>, <b>PREEMPTEE</b> , <b>DEDICATED</b>, <b>PREEMPTOR</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">cause Maui to force the specified job flags on all jobs supplied in the workload trace file</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMDEFAULTJOBFLAGS DEDICATED</pre></div> <p>(Maui will set the 'DEDICATED' job flag on all jobs loaded from the workload trace file)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simexititeration"></a> <b>SIMEXITITERATION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no exit iteration)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">iteration on which a Maui simulation will create a simulation summary and exit.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMEXITITERATION 36000</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simflags"></a> <b>SIMFLAGS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">zero or more of the following: <br /> <b>IGNHOSTLIST</b>, <b>IGNCLASS</b>, <b>IGNQOS</b>, <b>IGNMODE</b>, <b>IGNFEATURES</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">controls how Maui handles trace based information</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMFLAGS IGNHOSTLIST</pre></div> <p>(Maui will ignore hostlist information specified in the workload trace file)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simignorejobflags"></a> <b>SIMIGNOREJOBFLAGS</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">zero or more of the following: <br /> <b>ADVRES</b>, <b>HOSTLIST</b>, <b>RESTARTABLE</b>, <b>PREEMPTEE</b> , <b>DEDICATED</b>, <b>PREEMPTOR</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">cause Maui to ignore specified job flags if supplied in the workload trace file</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMIGNOREJOBFLAGS DEDICATED</pre></div> <p>(Maui will ignore the 'DEDICATED' job flag if specified in any job trace)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="siminitialqueuedepth"></a> <b>SIMINITIALQUEUEDEPTH</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">16</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how many jobs the simulator will initially place in the idle job queue</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMINITIALQUEUEDEPTH 64</pre></div> <div class="example"> <pre>SIMJOBSUBMISSIONPOLICY CONSTANTJOBDEPTH</pre></div> <p>(Maui will initially place 64 idle jobs in the queue and, because of the specified queue policy, will attempt to maintain this many jobs in the idle queue throughout the duration of the simulation)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simjobsubmissionpolicy"></a> <b>SIMJOBSUBMISSIONPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <b>NORMAL</b>, <b>CONSTANTJOBDEPTH</b>, or <b>CONSTANTPSDEPTH</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>CONSTANTJOBDEPTH</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how the simulator will submit new jobs into the idle queue. (NORMAL mode causes jobs to be submitted at the time recorded in the workload trace file, <b>CONSTANTJOBDEPTH</b> and <b>CONSTANTPSDEPTH</b> attempt to maintain an idle queue of <SIMINITIALQUEUEDEPTH> jobs and procseconds respectively)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMJOBSUBMISSIONPOLICY NORMAL</pre></div> <p>(Maui will submit jobs with the relative time distribution specified in the workload trace file.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simnodeconfiguration"></a> <b>SIMNODECONFIGURATION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of the following: <br /> <b>UNIFORM</b> or <b>NORMAL</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>NORMAL</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether or not maui will filter nodes based on resource configuration while running a simulation</td> </tr> <tr> <td class="contentLabels">Example:</td> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simnodecount"></a> <b>SIMNODECOUNT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no limit)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum number of nodes maui will load from the simulation resource file</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simresourcetracefile"></a> <b>SIMRESOURCETRACEFILE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">traces/resource.trace</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the file from which maui will obtain node information when running in simulation mode. Maui will attempt to locate the file relative to <MAUIHOMEDIR> unless specified as an absolute path</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMRESOURCETRACEFILE traces/nodes.1</pre></div> <p>(Maui will obtain node traces when running in simulation mode from the <MAUIHOMEDIR><tt>/traces/nodes.1</tt> file)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simrmrandomdelay"></a> <b>SIMRMRANDOMDELAY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the random delay added to the RM command base delay accumulated when making any resource manager call in simulation mode</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMRMRANDOMDELAY 5</pre></div> <p>(Maui will add a random delay of between 0 and 5 seconds to the simulated time delay of all RM calls)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simstopiteration"></a> <b>SIMSTOPITERATION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no stop iteration)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies on which scheduling iteration a maui simulation will stop and was for a command to resume scheduling</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMSTOPITERATION 1</pre></div> <p>(Maui should stop after the first iteration of simulated scheduling and wait for admin commands)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simtimeratio"></a> <b>SIMTIMERATIO</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no time ratio)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">determines wall time speedup. Simulated Maui time will advance <SIMTIMERATIO> * faster than real wall time.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMTIMERATIO 10</pre></div> <p>(Maui simulation time will advance 10 times faster than real world wall time. For example, in 1 hour, Maui will process 10 hours of simulated workload)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="simworkloadtracefile"></a> <b>SIMWORKLOADTRACEFILE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">traces/workload.trace</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the file from which maui will obtain job information when running in simulation mode. Maui will attempt to locate the file relative to <MAUIHOMEDIR> unless specified as an absolute path</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SIMWORKLOADTRACEFILE traces/jobs.2</pre></div> <p>(Maui will obtain job traces when running in simulation mode from the <MAUIHOMEDIR>/traces/jobs.2 file)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="sraccess"></a> <b>SRACCESS[X]</b> <br /> Deprecated in Maui 3.2 and higher <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">DEDICATED or SHARED</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">DEDICATED</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">If set to SHARED, allows a standing reservation to utilize resources already allocated to other non-job reservations. Otherwise, these other reservations will block resource access. (See <a href="7.1.5managingreservations.php"> Managing Reservations</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRACCESS[test] SHARED</pre></div> <p>(Standing reservation 'test' may access resources allocated to existing standing and administrative reservations)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="sraccountlist"></a> <b>SRACCOUNTLIST[X]</b> <br /> Deprecated in Maui 3.2 and higher <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of valid account names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies that jobs with the associated accounts may use the resources contained within this reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRACCOUNTLIST[1] ops staff</pre></div> <p>(jobs using the account <tt>ops</tt> or <tt>staff</tt> are granted access to the resources in standing reservation '1')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="srchargeaccount"></a> <b>SRCHARGEACCOUNT[X]</b> <br /> Deprecated in Maui 3.2 and higher <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">any valid accountname</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the account to which maui will charge all idle cycles within the reservation (via the allocation bank)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRCHARGEACCOUNT[test] steve</pre></div> <p>(The scheduler will charge all idle cycles within reservations supporting standing reservation test to user 'steve')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRCFG"></a> <b>SRCFG[X]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more of the following <ATTR>=<VALUE> pairs <br /> <b>ACCESS</b> <br /> <b>ACCOUNTLIST</b> <br /> <b>CHARGEACCOUNT</b> <br /> <b>CLASSLIST</b> <br /> <b>DAYS</b> <br /> <b>DEPTH</b> <br /> <b>ENDTIME</b> <br /> <b>FLAGS</b> <br /> <b>GROUPLIST</b> <br /> <b>HOSTLIST</b> <br /> <b>JOBATTRLIST</b> <br /> <b>NODEFEATURES</b> <br /> <b>OWNER</b> <br /> <b>PARTITION</b> <br /> <b>PERIOD</b> <br /> <b>PRIORITY</b> <br /> <b>QOSLIST</b> <br /> <b>RESOURCES</b> <br /> <b>STARTTIME</b> <br /> <b>TASKCOUNT</b> <br /> <b>TIMELIMIT</b> <br /> <b>TPN</b> <br /> <b>TRIGGER</b> <br /> <b>USERLIST</b> <br /> <br /> NOTE: <b>HOSTLIST</b> and <i>ACL</i> list values must be comma delimited. (i.e., HOSTLIST=nodeA,nodeB)</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies attributes of a standing reservation. Available in Maui 3.2 and higher. See <a href="7.1.5managingreservations.php">Managing Reservations</a> for details.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre><font size="-2">SRCFG[fast] STARTTIME=9:00:00 ENDTIME=15:00:00</font></pre></div> <div class="example"> <pre><font size="-2">SRCFG[fast] HOSTLIST=node0[1-4]$</font></pre></div> <div class="example"> <pre><font size="-2">SRCFG[fast] QOSLIST=high:low</font></pre></div> <p>(Maui will create a standing reservation running from 9:00 AM to 3:00 PM on nodes 1 through 4 accessible by jobs with QOS high or low.)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRCLASSLIST"></a> <b>SRCLASSLIST[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of valid class names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies that jobs requiring any of these classes may use the resources contained within this reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRCLASSLIST[2] interactive</pre></div> <p>(maui will allow all jobs requiring any of the classes listed access to the resources reserved by standing reservation '2')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRDAYS"></a> <b>SRDAYS[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more of the following (space delimited) <br /> <b>Mon,</b> <b>Tue,</b> <b>Wed</b>, <b>Thu,</b> <b>Fri,</b> <b>Sat,</b> <b>Sun</b>, or <b>[ALL]</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>[ALL]</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies which days of the week the standing reservation will be active</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRDAYS[1] Mon Tue Wed Thu Fri</pre></div> <p>(standing reservation '1' will be active on Monday thru Friday)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRDEPTH"></a> <b>SRDEPTH[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">2</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the number of standing reservations which will be created (one per day)</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRDEPTH[1] 7</pre></div> <p>(specifies that standing reservations will be created for standing reservation '1' for today, and the next 6 days)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRENDTIME"></a> <b>SRENDTIME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">24:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the time of day the standing reservation becomes inactive</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRSTARTTIME[2] 8:00:00</pre></div> <div class="example"> <pre>SRENDTIME[2] 17:00:00</pre></div> <p>(standing reservation '2' is active from 8:00 AM until 5:00 PM)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRFEATURES"></a> <b>SRFEATURES[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a> <br /> Replaced with <a href="7.1.5managingreservations.php">NODEFEATURES</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of node features</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the required node features for nodes which will be part of the standing reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRFEATURES[3] wide fddi</pre></div> <p>(all nodes used in the standing reservation must have both the 'wide' and 'fddi' node attributes)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRFLAGS"></a> <b>SRFLAGS</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">colon delimited list of zero or more of the following flags: <br /> <b>SINGLEUSE</b>* <br /> <b>BYNAME</b> <br /> <b>PREEMPTEE</b>* <br /> <b>TIMEFLEX</b>* <br /> <b>FORCE</b> <p></p></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies special reservation attributes. See <a href="7.1.5managingreservations.php"> Managing Reservations</a> for details.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRFLAGS[1] BYNAME</pre></div> <p>(Jobs may only access the resources within this reservation if they explicitly request the reservation 'by name'</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRGROUPLIST"></a> <b>SRGROUPLIST[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more space delimited group names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[ALL]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the groups which will be allowed access to this standing reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRGROUPLIST[1] staff ops special</pre></div> <div class="example"> <pre>SRCLASSLIST[1] interactive</pre></div> <p>(Maui will allow jobs with the listed group ID's or which request the job class 'interactive' to use the resources covered by standing reservation 1.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRHOSTLIST"></a> <b>SRHOSTLIST[X]</b><br /> Deprecated in Maui 3.2 <br /> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one or more space delimited host names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[ALL]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the set of host from which Maui can search for resources to satisfy the reservation. If SRTASKCOUNT is also specified, only <SRTASKCOUNT> tasks will be reserved. Otherwise, all hosts listed will be reserved.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRHOSTLIST[3] node001 node002 node003</pre></div> <div class="example"> <pre>SRRESOURCES[3] PROCS=2;MEM=512</pre></div> <div class="example"> <pre>SRTASKCOUNT[3] 2</pre></div> <p>(Maui will reserve 2 tasks - with 2 processors and 512 MB each, using resources located on node001, node002, and/or node003)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRMAXTIME"></a> <b>SRMAXTIME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a> <br> Replaced with <a href="7.1.5managingreservations.php">TIMELIMIT</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (no time based access)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum allowed overlap between a the standing reservation and a job requesting resource access</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRMAXTIME[6] 1:00:00</pre></div> <p>(Maui will allow jobs to access up to one hour of resources in standing reservation 6)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRNAME"></a> <b>SRNAME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a> <br> SRNAME should no longer be used </td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies name of standing reservation <X></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentLabels bottomRow">Example:</td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRPARTITION"></a> <b>SRPARTITION[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[ALL]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the partition in which the standing reservation should be created</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRPARTITION[0] OLD</pre></div> <p>(only select resource for standing reservation 0 in partition 'OLD')</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRPERIOD"></a> <b>SRPERIOD[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>DAY</b>, <b>WEEK</b>, or <b>INFINITY</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>DAY</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies the periodicity of the standing reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRPERIOD[1] WEEK</pre></div> <p>(each standing reservation covers a one week period)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRQOSLIST"></a> <b>SRQOSLIST[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">zero or more valid QOS names</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies that jobs with the listed QOS names can access the reserved resources</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRQOSLIST[1] 1 3 4 5</pre></div> <p>(maui will allow jobs using QOS 1, 3, 4, and 5 to use the reserved resources)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRRESOURCES"></a> <b>SRRESOURCES[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">semicolon delimited <ATTR>=<VALUE> pairs</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">PROCS=-1 (All processors available on node)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies what resources constitute a single standing reservation task. (each task must be able to obtain all of its resources as an atomic unit on a single node) Supported resources currently include the following: <p>PROCS (number of processors) <br /> MEM (real memory in MB) <br /> DISK (local disk in MB) <br /> SWAP (virtual memory in MB)</p></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRRESOURCES[1] PROCS=1;MEM=512</pre></div> <p>(each standing reservation task will reserve one processor and 512 MB of real memory)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRSTARTTIME"></a> <b>SRSTARTTIME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">00:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the time of day the standing reservation becomes active</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRSTARTTIME[1] 08:00:00</pre></div> <div class="example"> <pre>SRENDTIME[1] 17:00:00</pre></div> <p>(standing reservation '1' is active from 8:00 AM until 5:00 PM)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRTASKCOUNT"></a> <b>SRTASKCOUNT[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies how may tasks should be reserved for the reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRRESOURCES[2] PROCS=1;MEM=256</pre></div> <div class="example"> <pre>SRTASKCOUNT[2] 16</pre></div> <p>(standing reservation '2' will reserve 16 tasks worth of resources, in this case, 16 procs and 4 GB of real memory)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRTIMELOGIC"></a> <b>SRTIMELOGIC[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><b>AND</b> or <b>OR</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>OR</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how SRMAXTIME access status will be combined with other standing reservation access methods to determine job access. If SRTIMELOGIC is set to OR, a job is granted access to the reserved resources if it meets the MAXTIME criteria or any other access criteria (i.e., SRUSERLIST) If SRTIMELOGIC is set to AND, a job is granted access to the reserved resources only if it meets the MAXTIME criteria and at least on other access criteria</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRMAXTIME[5] 1:00:00</pre></div> <div class="example"> <pre>SRUSERLIST[5] carol charles</pre></div> <div class="example"> <pre>SRTIMELOGIC[5] AND</pre></div> <p>(Maui will allow jobs from users carol and charles to use up to one hour of resources in standing reservation 5)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRTPN"></a> <b>SRTPN[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (no TPN constraint)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum number of tasks per node which must be available on eligible nodes.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRTPN[2] 4</pre></div> <div class="example"> <pre>SRRESOURCES[2] PROCS=2;MEM=256</pre></div> <p>(Maui must locate at least 4 tasks on each node that is to be part of the reservation. That is, each node included in standing reservation '2' must have at least 8 processors and 1 GB of memory available)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRUSERLIST"></a> <b>SRUSERLIST[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">space delimited list of users</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies which users have access to the resources reserved by this reservation</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRUSERLIST[1] bob joe mary</pre></div> <p>(users bob, joe and mary can all access the resources reserved within this reservation)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRWENDTIME"></a> <b>SRWENDTIME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">7:00:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the week offset at which the stand reservation should end</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRSTARTTIME[1] 1:08:00:00</pre></div> <div class="example"> <pre>SRENDTIME[1] 5:17:00:00</pre></div> <p>(standing reservation '1' will run from Monday 8:00 AM to Friday 5:00 PM)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="SRWSTARTTIME"></a> <b>SRWSTARTTIME[X]</b><br> Deprecated in Maui 3.2 <br> Refer to <a href="#SRCFG">SRCFG</a></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0:00:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the week offset at which the standing reservation should start</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SRSTARTTIME[1] 1:08:00:00</pre></div> <div class="example"> <pre>SRENDTIME[1] 5:17:00:00</pre></div> <p>(standing reservation '1' will run from Monday 8:00 AM to Friday 5:00 PM)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="statdir"></a> <b>STATDIR</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">stats</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the directory in which Maui statistics will be maintained</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>STATDIR /var/adm/maui/stats</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="syscfg"></a> <b>SYSCFG</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <br> <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QLIST</b>, <b>QDEF</b>, <b>PLIST</b> , <b>PDEF</b>, <b>FLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies system-wide default attributes. See the <a href="jobflagoverview.php"> Attribute/Flag Overview</a> for more information. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SYSCFG PLIST=Partition1 QDEF=highprio</pre></div> <p>(by default, all jobs will have access to partition <tt>Partition1</tt> and will use the QOS <tt>highprio</tt>) </p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="swapweight"></a> <b>SWAPWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the priority weight assigned to the virtual memory request of a job</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SWAPWEIGHT 10</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="systemdefaultjobwalltime"></a> <b>SYSTEMDEFAULTJOBWALLTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">10:00:00:00</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the walltime for jobs which do not explicitly set this value</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SYSTEMDEFAULTJOBWALLTIME 1:00:00:00</pre></div> <p>(Maui will assign a wallclock limit of 1 day to jobs which do not explicitly specify a wallclock limit)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="systemmaxjobproc"></a> <b>SYSTEMMAXPROCPERJOB</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (NO LIMIT)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum number of processors that can be requested by any single job</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SYSTEMMAXJOBPROC 256</pre></div> <p>(Maui will reject jobs requesting more than 256 processors)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="systemmaxjobprocsecond"></a> <b>SYSTEMMAXPROCSECONDPERJOB</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (NO LIMIT)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum number of proc-seconds that can be requested by any single job</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SYSTEMMAXJOBPROCSECOND 86400</pre></div> <p>(Maui will reject jobs requesting more than 86400 procs seconds. i.e., 64 processors * 30 minutes will be rejected, while a 2 processor * 12 hour job will be allowed to run)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="systemmaxjobwalltime"></a> <b>SYSTEMMAXJOBWALLTIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (NO LIMIT)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum amount of wallclock time that can be requested by any single job</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>SYSTEMMAXJOBWALLTIME 1:00:00:00</pre></div> <p>(Maui will reject jobs requesting more than one day of walltime)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="targweight"></a> <b>TARGWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight to be applied to a job's queuetime and expansion factor target components</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TARGETWEIGHT 1000</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="taskdistributionpolicy"></a> <b>TASKDISTRIBUTIONPOLICY</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">one of <b>DEFAULT</b> or <b>LOCAL</b></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"><b>DEFAULT</b></td> </tr> <tr><td class="contentLabels">Details:</td> <td class="contentDetails">specifies how job tasks should be mapped to allocated resources.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TASKDISTRIBUTIONPOLICY DEFAULT</pre></div> <p>(Maui should use standard task distribution algorithms)</p></td> </tr> <tr> <td class="contentDetails"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="trapfunction"></a> <b>TRAPFUNCTION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the functions to be trapped</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TRAPFUNCTION UpdateNodeUtilization|GetNodeSResTime</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="trapjob"></a> <b>TRAPJOB</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the jobs to be trapped</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TRAPJOB buffy.0023.0</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="trapnode"></a> <b>TRAPNODE</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the nodes to be trapped</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TRAPNODE node001|node004|node005</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="trapres"></a> <b>TRAPRES</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><STRING></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the reservations to be trapped</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>TRAPRES interactive.0.1</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="usageweight"></a> <b>USAGEWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight assigned to the percent and total job usage subfactors</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>USAGEWEIGHT 100</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="usagepercentweight"></a> <b>USAGEPERCENTWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails"></td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="usemachinespeed"></a> <b>USEMACHINESPEED</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">ON or OFF</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">OFF</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether or not job wallclock limits should be scaled by the machine speed of the node(s) they are running on.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>USEMACHINESPEED ON</pre></div> <p>(job <X> specifying a wallclock limit of 1:00:00 would be given only 40 minutes to run if started on a node with a machine speed of 1.5)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="usercfg"></a> <b>USERCFG[<USERID>]</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">list of zero or more space delimited <ATTR>=<VALUE> pairs where <ATTR> is one of the following: <br> <b>PRIORITY</b>, <b>FSTARGET</b>, <b>QLIST</b>, <b>QDEF</b>, <b>PLIST</b> , <b>PDEF</b>, <b>FLAGS</b>, or a <a href="6.2throttlingpolicies.php">fairness policy</a> specification.</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">[NONE]</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies user specific attributes. See the <a href="jobflagoverview.php"> flag overview</a> for a description of legal flag values. </td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>USERCFG[john] MAXJOB=50 QDEF=highprio</pre></div> <p>(up to 50 jobs submitted under the user ID <tt>john</tt> will be allowed to execute simultaneously and will be assigned the QOS <tt>highprio<tt> by default.)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="userweight"></a> <b>USERWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight assigned to the specified user priority (see <a href="5.1.2priorityfactors.php#cred">Credential Priority Factor</a> )</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>USERWEIGHT 100</pre></div></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="usesystemqueuetime"></a> <b>USESYSTEMQUEUETIME</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">ON or OFF</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">OFF</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies whether or not job prioritization should be based on the time the job has been eligible to run, i.e., idle and meets all fairness policies (ON) or the time the job has been idle (OFF). NOTE: In Maui 3.0.8 and higher, this parameter has been superseded by the <a href="#jobprioaccrualpolicy"> JOBPRIOACCRUALPOLICY</a> parameter.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>USESYSTEMQUEUETIME OFF</pre></div> <p>(the queuetime and expansion factor components of a job's priority will be calculated based on the length of time the job has been in the idle state.) <div class="example"> (See <a href="5.1.2priorityfactors.php">QUEUETIMEFACTOR</a> for more info)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="wcviolationaction"></a> <b>WCVIOLATIONACTION</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><one of CANCEL or PREEMPT></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">CANCEL</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the action to take when a job exceeds its wallclock limit. If set to cancel, the job will be terminated. If set to PREEMPT, the action defined by PREEMPTPOLICY parameter will be taken.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>WCVIOLATIONACTION PREEMPT</pre></div><div class="example"> <pre>PREEMPTPOLICY REQUEUE</pre></div> <p> </p> <p>(Maui will requeue jobs which exceed their wallclock limit)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="xfactorcap"></a> <b>XFACTORCAP</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><DOUBLE></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0 (NO CAP)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the maximum total pre-weighted contribution to job priority which can be contributed by the expansion factor component. This value is specified as an absolute priority value, not as a percent.</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>XFACTORCAP 10000</pre></div> <p>(Maui will not allow a job's pre-weighted XFactor priority component to exceed the value 10000)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="xfminwclimit"></a> <b>XFMINWCLIMIT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails">[[[DD:]HH:]MM:]SS</td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">-1 (NO LIMIT)</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the minimum job wallclock limit that will be considered in job expansion factor priority calculations</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>XFMINWCLIMIT 0:01:00</pre></div> <p>(jobs requesting less than one minute of wallclock time will be treated as if their wallclock limit was set to one minute when determining expansion factor for priority calculations)</p></td> </tr> </tbody> <tr class="blank"> <td> </td> <td> </td> </tr> <tbody> <tr> <td colspan="2" class="featureName"><a name="xfactorweight"></a> <b>XFACTORWEIGHT</b></td> </tr> <tr> <td class="contentLabels">Format:</td> <td class="contentDetails"><INTEGER></td> </tr> <tr> <td class="contentLabels">Default:</td> <td class="contentDetails">0</td> </tr> <tr> <td class="contentLabels">Details:</td> <td class="contentDetails">specifies the weight to be applied to a job's minimum expansion factor before it is added to the job's cumulative priority</td> </tr> <tr> <td class="contentLabels bottomRow">Example:</td> <td class="contentDetails bottomRow" id="bottomDetail"> <div class="example"> <pre>XFACTORWEIGHT 1000</pre></div> <p>(Maui will multiply a job's XFactor value by 1000 and then add this value to its total priority</p></td> </tr> </tbody> </table> <div class="navIcons bottomIcons"> <a href="index.php"><img src="/resources/docs/images/home.png" title="Home" alt="Home" border="0"></a> <a href="index.php"><img src="/resources/docs/images/upArrow.png" title="Up" alt="Up" border="0"></a> <a href="a.esecurity.php"><img src="/resources/docs/images/prevArrow.png" title="Previous" alt="Previous" border="0"></a> <a href="a.gcommandoverview.php"><img src="/resources/docs/images/nextArrow.png" title="Next" alt="Next" border="0"></a> </div> </div> <div class="sub-content-btm"></div> </div>