qalter.html

posix标准英文,html格式

<blockquote>
<p>Not used.</p>
</blockquote>

<h4><a name="tag_04_106_07"></a>INPUT FILES</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_08"></a>ENVIRONMENT VARIABLES</h4>

<blockquote>
<p>The following environment variables shall affect the execution of <i>qalter</i>:</p>

<dl compact>
<dt><i>LANG</i></dt>

<dd>Provide a default value for the internationalization variables that are unset or null. (See the Base Definitions volume of
IEEE&nbsp;Std&nbsp;1003.1-2001, <a href="../basedefs/xbd_chap08.html#tag_08_02">Section 8.2, Internationalization Variables</a> for
the precedence of internationalization variables used to determine the values of locale categories.)</dd>

<dt><i>LC_ALL</i></dt>

<dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd>

<dt><i>LC_CTYPE</i></dt>

<dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as
opposed to multi-byte characters in arguments).</dd>

<dt><i>LC_MESSAGES</i></dt>

<dd>Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard
error.</dd>

<dt><i>LOGNAME</i></dt>

<dd>Determine the login name of the user.</dd>

<dt><i>TZ</i></dt>

<dd>Determine the timezone used to interpret the <i>date-time</i> option-argument. If <i>TZ</i> is unset or null, an unspecified
default timezone shall be used.</dd>
</dl>
</blockquote>

<h4><a name="tag_04_106_09"></a>ASYNCHRONOUS EVENTS</h4>

<blockquote>
<p>Default.</p>
</blockquote>

<h4><a name="tag_04_106_10"></a>STDOUT</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_11"></a>STDERR</h4>

<blockquote>
<p>The standard error shall be used only for diagnostic messages.</p>
</blockquote>

<h4><a name="tag_04_106_12"></a>OUTPUT FILES</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_13"></a>EXTENDED DESCRIPTION</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_14"></a>EXIT STATUS</h4>

<blockquote>
<p>The following exit values shall be returned:</p>

<dl compact>
<dt>&nbsp;0</dt>

<dd>Successful completion.</dd>

<dt>&gt;0</dt>

<dd>An error occurred.</dd>
</dl>
</blockquote>

<h4><a name="tag_04_106_15"></a>CONSEQUENCES OF ERRORS</h4>

<blockquote>
<p>In addition to the default behavior, the <i>qalter</i> utility shall not be required to write a diagnostic message to standard
error when the error reply received from a batch server indicates that the batch <i>job_identifier</i> does not exist on the
server. Whether or not the <i>qalter</i> utility attempts to locate the batch job on other batch servers is
implementation-defined.</p>
</blockquote>

<hr>
<div class="box"><em>The following sections are informative.</em></div>

<h4><a name="tag_04_106_16"></a>APPLICATION USAGE</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_17"></a>EXAMPLES</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_18"></a>RATIONALE</h4>

<blockquote>
<p>The <i>qalter</i> utility allows users to change the attributes of a batch job.</p>

<p>As a means of altering a queued job, the <i>qalter</i> utility is superior to deleting and requeuing the batch job insofar as an
altered job retains its place in the queue with some traditional selection algorithms. In addition, the <i>qalter</i> utility is
both shorter and simpler than a sequence of <a href="../utilities/qdel.html"><i>qdel</i></a> and <a href=
"../utilities/qsub.html"><i>qsub</i></a> utilities.</p>

<p>The result of an attempt on the part of a user to alter a batch job in a RUNNING state is implementation-defined because a batch
job in the RUNNING state will already have opened its output files and otherwise performed any actions indicated by the options in
effect at the time the batch job began execution.</p>

<p>The options processed by the <i>qalter</i> utility are identical to those of the <a href=
"../utilities/qsub.html"><i>qsub</i></a> utility, with a few exceptions: <b>-V</b>, <b>-v</b>, and <b>-q</b>. The <b>-V</b> and
<b>-v</b> are inappropriate for the <i>qalter</i> utility, since they capture potentially transient environment information from
the submitting process. The <b>-q</b> option would specify a new queue, which would largely negate the previously stated advantage
of using <i>qalter</i>; furthermore, the <a href="../utilities/qmove.html"><i>qmove</i></a> utility provides a superior means of
moving jobs.</p>

<p>Each of the following paragraphs provides the rationale for a <i>qalter</i> option.</p>

<p>Additional rationale concerning these options can be found in the rationale for the <a href=
"../utilities/qsub.html"><i>qsub</i></a> utility.</p>

<p>The <b>-a</b> option allows users to alter the date and time at which a batch job becomes eligible to run.</p>

<p>The <b>-A</b> option allows users to change the account that will be charged for the resources consumed by the batch job.
Support for the <b>-A</b> option is mandatory for conforming implementations of <i>qalter</i>, even though support of accounting is
optional for servers. Whether or not to support accounting is left to the implementor of the server, but mandatory support of the
<b>-A</b> option assures users of a consistent interface and allows them to control accounting on servers that support
accounting.</p>

<p>The <b>-c</b> option allows users to alter the checkpointing interval of a batch job. A checkpointing system, which is not
defined by IEEE&nbsp;Std&nbsp;1003.1-2001, allows recovery of a batch job at the most recent checkpoint in the event of a crash.
Checkpointing is typically used for jobs that consume expensive computing time or must meet a critical schedule. Users should be
allowed to make the tradeoff between the overhead of checkpointing and the risk to the timely completion of the batch job;
therefore, this volume of IEEE&nbsp;Std&nbsp;1003.1-2001 provides the checkpointing interval option. Support for checkpointing is
optional for servers.</p>

<p>The <b>-e</b> option allows users to alter the name and location of the standard error stream written by a batch job. However,
the path of the standard error stream is meaningless if the value of the <i>Join_Path</i> attribute of the batch job is TRUE.</p>

<p>The <b>-h</b> option allows users to set the hold type in the <i>Hold_Types</i> attribute of a batch job. The <a href=
"../utilities/qhold.html"><i>qhold</i></a> and <a href="../utilities/qrls.html"><i>qrls</i></a> utilities add or remove hold types
to the <i>Hold_Types</i> attribute, respectively. The <b>-h</b> option has been modified to allow for implementation-defined hold
types.</p>

<p>The <b>-j</b> option allows users to alter the decision to join (merge) the standard error stream of the batch job with the
standard output stream of the batch job.</p>

<p>The <b>-l</b> option allows users to change the resource limits imposed on a batch job.</p>

<p>The <b>-m</b> option allows users to modify the list of points in the life of a batch job at which the designated users will
receive mail notification.</p>

<p>The <b>-M</b> option allows users to alter the list of users who will receive notification about events in the life of a batch
job.</p>

<p>The <b>-N</b> option allows users to change the name of a batch job.</p>

<p>The <b>-o</b> option allows users to alter the name and path to which the standard output stream of the batch job will be
written.</p>

<p>The <b>-P</b> option allows users to modify the priority of a batch job. Support for priority is optional for batch servers.</p>

<p>The <b>-r</b> option allows users to alter the rerunability status of a batch job.</p>

<p>The <b>-S</b> option allows users to change the name and location of the shell image that will be invoked to interpret the
script of the batch job. This option has been modified to allow a list of shell name and locations associated with different
hosts.</p>

<p>The <b>-u</b> option allows users to change the user identifier under which the batch job will execute.</p>

<p>The <i>job_identifier</i> operand syntax is provided so that the user can differentiate between the originating and destination
(or executing) batch server. These may or may not be the same. The . <i>server_name</i> portion identifies the originating batch
server, while the @ <i>server</i> portion identifies the destination batch server.</p>

<p>Historically, the <i>qalter</i> utility has been a component of the Network Queuing System (NQS), the existing practice from
which this utility has been derived.</p>
</blockquote>

<h4><a name="tag_04_106_19"></a>FUTURE DIRECTIONS</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_106_20"></a>SEE ALSO</h4>

<blockquote>
<p><a href="xcu_chap03.html#tag_03"><i>Batch Environment Services</i></a>, <a href="qdel.html"><i>qdel</i></a>, <a href=
"qhold.html"><i>qhold</i></a>, <a href="qmove.html"><i>qmove</i></a>, <a href="qrls.html"><i>qrls</i></a>, <a href=
"qsub.html"><i>qsub</i></a>, <a href="touch.html"><i>touch</i></a></p>
</blockquote>

<h4><a name="tag_04_106_21"></a>CHANGE HISTORY</h4>

<blockquote>
<p>Derived from IEEE&nbsp;Std&nbsp;1003.2d-1994.</p>
</blockquote>

<h4><a name="tag_04_106_22"></a>Issue 6</h4>

<blockquote>
<p>The <i>TZ</i> entry is added to the ENVIRONMENT VARIABLES section.</p>

<p>IEEE PASC Interpretation 1003.2 #182 is applied, clarifying the description of the <b>-a</b> option.</p>
</blockquote>

<div class="box"><em>End of informative text.</em></div>

<hr size="2" noshade>
<center><font size="2"><!--footer start-->
UNIX &reg; is a registered Trademark of The Open Group.<br>
POSIX &reg; is a registered Trademark of The IEEE.<br>
[ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
"../utilities/contents.html">XCU</a> | <a href="../functions/contents.html">XSH</a> | <a href="../xrat/contents.html">XRAT</a>
]</font></center>

<!--footer end-->
<hr size="2" noshade>
</body>
</html>