qalter.html

posix标准英文,html格式

<dd>Redefine which output of the batch job to retain on the execution host. 

<p>The <i>qalter</i> <b>-k</b> option shall accept a value for the <i>keep_list</i> option-argument that is a string of
alphanumeric characters in the portable character set.</p>

<p>The <i>qalter</i> utility shall accept a <i>keep_list</i> option-argument that consists of one or more of the characters
<tt>'e'</tt> and <tt>'o'</tt>, or the single character <tt>'n'</tt>.</p>

<p>For each unique character in the <i>keep_list</i> option-argument, the <i>qalter</i> utility shall add a value to the
<i>Keep_Files</i> attribute of the batch job as follows, each representing a different batch job stream to keep:</p>

<dl compact>
<dt><tt>e</tt></dt>

<dd>The standard error of the batch job (KEEP_STD_ERROR).</dd>

<dt><tt>o</tt></dt>

<dd>The standard output of the batch job (KEEP_STD_OUTPUT).</dd>
</dl>

<p>If both <tt>'e'</tt> and <tt>'o'</tt> are specified, then both files are retained. An existing <i>Keep_Files</i> attribute can
be cleared by the keep type:</p>

<dl compact>
<dt><tt>n</tt></dt>

<dd>NO_KEEP</dd>
</dl>

<p>If <tt>'n'</tt> is specified, then no files are retained. The <i>qalter</i> utility shall consider it an error if any keep type
other than <tt>'n'</tt> is combined with keep type <tt>'n'</tt>.</p>

<p>Strictly conforming applications shall not repeat any of the characters <tt>'e'</tt>, <tt>'o'</tt>, or <tt>'n'</tt> within the
<i>keep_list</i> option-argument. The <i>qalter</i> utility shall permit the repetition of characters, but shall not assign
additional meaning to the repeated characters. An implementation may define other keep types. The conformance document for an
implementation shall describe any additional keep types, how they are specified, their internal behavior, and how they affect the
behavior of the utility.</p>
</dd>

<dt><b>-l&nbsp;</b> <i>resource_list</i></dt>

<dd>
Redefine the resources that are allowed or required by the batch job. 

<p>The <i>qalter</i> utility shall accept a <i>resource_list</i> option-argument that conforms to the following syntax:</p>

<pre>
<tt>resource=value[,,resource=value,,...]
</tt>
</pre>

<p>The <i>qalter</i> utility shall set one entry in the value of the <i>Resource_List</i> attribute of the batch job for each
resource listed in the <i>resource_list</i> option-argument.</p>

<p>Because the list of supported resource names might vary by batch server, the <i>qalter</i> utility shall rely on the batch
server to validate the resource names and associated values. See <a href="xcu_chap03.html#tag_03_03_03"><i>Multiple Keyword-Value
Pairs</i></a> for a means of removing <i>keyword</i>= <i>value</i> (and <i>value</i>@ <i>keyword</i>) pairs and other general rules
for list-oriented batch job attributes.</p>
</dd>

<dt><b>-m&nbsp;</b> <i>mail_options</i></dt>

<dd>
Redefine the points in the execution of the batch job at which the batch server is to send mail about a change in the state of the
batch job. 

<p>The <i>qalter</i> <b>-m</b> option shall accept a value for the <i>mail_options</i> option-argument that is a string of
alphanumeric characters in the portable character set.</p>

<p>The <i>qalter</i> utility shall accept a value for the <i>mail_options</i> option-argument that is a string of one or more of
the characters <tt>'e'</tt>, <tt>'b'</tt>, and <tt>'a'</tt>, or the single character <tt>'n'</tt>. For each unique character in
the <i>mail_options</i> option-argument, the <i>qalter</i> utility shall add a value to the <i>Mail_Users</i> attribute of the
batch job as follows, each representing a different time during the life of a batch job at which to send mail:</p>

<dl compact>
<dt><tt>e</tt></dt>

<dd>MAIL_AT_EXIT</dd>

<dt><tt>b</tt></dt>

<dd>MAIL_AT_BEGINNING</dd>

<dt><tt>a</tt></dt>

<dd>MAIL_AT_ABORT</dd>
</dl>

<p>If any of these characters are duplicated in the <i>mail_options</i> option-argument, the duplicates shall be ignored.</p>

<p>An existing <i>Mail_Points</i> attribute can be cleared by the mail type:</p>

<dl compact>
<dt><tt>n</tt></dt>

<dd>NO_MAIL</dd>
</dl>

<p>If <tt>'n'</tt> is specified, then mail is not sent. The <i>qalter</i> utility shall consider it an error if any mail type other
than <tt>'n'</tt> is combined with mail type <tt>'n'</tt>. Strictly conforming applications shall not repeat any of the characters
<tt>'e'</tt>, <tt>'b'</tt>, <tt>'a'</tt>, or <tt>'n'</tt> within the <i>mail_options</i> option-argument. The <i>qalter</i>
utility shall permit the repetition of characters but shall not assign additional meaning to the repeated characters.</p>

<p>An implementation may define other mail types. The conformance document for an implementation shall describe any additional mail
types, how they are specified, their internal behavior, and how they affect the behavior of the utility.</p>
</dd>

<dt><b>-M&nbsp;</b> <i>mail_list</i></dt>

<dd>Redefine the list of users to which the batch server that executes the batch job is to send mail, if the batch server sends
mail about the batch job. 

<p>The syntax of the <i>mail_list</i> option-argument is unspecified. If the implementation of the <i>qalter</i> utility uses a
name service to locate users, the utility shall accept the syntax used by the name service.</p>

<p>If the implementation of the <i>qalter</i> utility does not use a name service to locate users, the implementation shall accept
the following syntax for user names:</p>

<pre>
<tt>mail_address[,,mail_address,,...]
</tt>
</pre>

<p>The interpretation of <i>mail_address</i> is implementation-defined.</p>

<p>The <i>qalter</i> utility shall set the <i>Mail_Users</i> attribute of the batch job to the value of the <i>mail_list</i>
option-argument.</p>
</dd>

<dt><b>-N&nbsp;</b> <i>name</i></dt>

<dd>Redefine the name of the batch job. 

<p>The <i>qalter</i> <b>-N</b> option shall accept a value for the <i>name</i> option-argument that is a string of up to 15
alphanumeric characters in the portable character set where the first character is alphabetic.</p>

<p>The syntax of the <i>name</i> option-argument is unspecified.</p>

<p>The <i>qalter</i> utility shall set the <i>Job_Name</i> attribute of the batch job to the value of the <i>name</i>
option-argument.</p>
</dd>

<dt><b>-o&nbsp;</b> <i>path_name</i></dt>

<dd>
Redefine the path for the standard output of the batch job. 

<p>The <i>qalter</i> utility shall accept a <i>path_name</i> option-argument that conforms to the syntax of the <i>path_name</i>
element defined in the System Interfaces volume of IEEE&nbsp;Std&nbsp;1003.1-2001, which can be preceded by a host name element of
the form <i>hostname</i>:.</p>

<p>If the <i>path_name</i> option-argument constitutes an absolute pathname, the <i>qalter</i> utility shall set the
<i>Output_Path</i> attribute of the batch job to the value of the <i>path_name</i> option-argument.</p>

<p>If the <i>path_name</i> option-argument constitutes a relative pathname and no host name element is specified, the <i>qalter</i>
utility shall set the <i>Output_Path</i> attribute of the batch job to the absolute pathname derived by expanding the
<i>path_name</i> option-argument relative to the current directory of the process that executes the <i>qalter</i> utility.</p>

<p>If the <i>path_name</i> option-argument constitutes a relative pathname and a host name element is specified, the <i>qalter</i>
utility shall set the <i>Output_Path</i> attribute of the batch job to the value of the <i>path_name</i> option-argument without
any expansion of the pathname.</p>

<p>If the <i>path_name</i> option-argument does not include a host name element, the <i>qalter</i> utility shall prefix the
pathname in the <i>Output_Path</i> attribute with <i>hostname</i>:, where <i>hostname</i> is the name of the host upon which the
<i>qalter</i> utility is being executed.</p>
</dd>

<dt><b>-p&nbsp;</b> <i>priority</i></dt>

<dd>Redefine the priority of the batch job. 

<p>The <i>qalter</i> utility shall accept a value for the priority option-argument that conforms to the syntax for signed decimal
integers, and which is not less than -1024 and not greater than 1023.</p>

<p>The <i>qalter</i> utility shall set the <i>Priority</i> attribute of the batch job to the value of the <i>priority</i>
option-argument.</p>
</dd>

<dt><b>-r&nbsp;</b> <tt>y</tt>|<tt>n</tt></dt>

<dd>Redefine whether the batch job is rerunnable. 

<p>If the value of the option-argument is <tt>'y'</tt>, the <i>qalter</i> utility shall set the <i>Rerunable</i> attribute of the
batch job to TRUE.</p>

<p>If the value of the option-argument is <tt>'n'</tt>, the <i>qalter</i> utility shall set the <i>Rerunable</i> attribute of the
batch job to FALSE.</p>

<p>The <i>qalter</i> utility shall consider it an error if any character other than <tt>'y'</tt> or <tt>'n'</tt> is specified in
the option-argument.</p>
</dd>

<dt><b>-S&nbsp;</b> <i>path_name_list</i></dt>

<dd>
Redefine the shell that interprets the script at the destination system. 

<p>The <i>qalter</i> utility shall accept a <i>path_name_list</i> option-argument that conforms to the following syntax:</p>

<pre>
<tt>pathname[@host][,pathname[@host],...]
</tt>
</pre>

<p>The <i>qalter</i> utility shall accept only one pathname that is missing a corresponding host name. The <i>qalter</i> utility
shall allow only one pathname per named host.</p>

<p>The <i>qalter</i> utility shall add a value to the <i>Shell_Path_List</i> attribute of the batch job for each entry in the
<i>path_name_list</i> option-argument. See <a href="xcu_chap03.html#tag_03_03_03"><i>Multiple Keyword-Value Pairs</i></a> for a
means of removing <i>keyword</i>= <i>value</i> (and <i>value</i>@ <i>keyword</i>) pairs and other general rules for list-oriented
batch job attributes.</p>
</dd>

<dt><b>-u&nbsp;</b> <i>user_list</i></dt>

<dd>Redefine the user name under which the batch job is to run at the destination system. 

<p>The <i>qalter</i> utility shall accept a <i>user_list</i> option-argument that conforms to the following syntax:</p>

<pre>
<tt>username[@host][,,username[@host],,...]
</tt>
</pre>

<p>The <i>qalter</i> utility shall accept only one user name that is missing a corresponding host name. The <i>qalter</i> utility
shall accept only one user name per named host.</p>

<p>The <i>qalter</i> utility shall add a value to the <i>User_List</i> attribute of the batch job for each entry in the
<i>user_list</i> option-argument. See <a href="xcu_chap03.html#tag_03_03_03"><i>Multiple Keyword-Value Pairs</i></a> for a means of
removing <i>keyword</i>= <i>value</i> (and <i>value</i>@ <i>keyword</i>) pairs and other general rules for list-oriented batch job
attributes.</p>
</dd>
</dl>
</blockquote>

<h4><a name="tag_04_106_05"></a>OPERANDS</h4>

<blockquote>
<p>The <i>qalter</i> utility shall accept one or more operands that conform to the syntax for a batch <i>job_identifier</i> (see <a
href="xcu_chap03.html#tag_03_03_01"><i>Batch Job Identifier</i></a>).</p>
</blockquote>

<h4><a name="tag_04_106_06"></a>STDIN</h4>