📄 qalter.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta name="generator" content="HTML Tidy, see www.w3.org"><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><link type="text/css" rel="stylesheet" href="style.css"><!-- Generated by The Open Group's rhtm tool v1.2.1 --><!-- Copyright (c) 2001-2004 IEEE and The Open Group, All Rights Reserved --><title>qalter</title></head><body bgcolor="white"><script type="text/javascript" language="JavaScript" src="../jscript/codes.js"></script><basefont size="3"> <a name="qalter"></a> <a name="tag_04_106"></a><!-- qalter --> <!--header start--><center><font size="2">The Open Group Base Specifications Issue 6<br>IEEE Std 1003.1, 2004 Edition<br>Copyright © 2001-2004 The IEEE and The Open Group, All Rights reserved.</font></center><!--header end--><hr size="2" noshade><h4><a name="tag_04_106_01"></a>NAME</h4><blockquote>qalter - alter batch job</blockquote><h4><a name="tag_04_106_02"></a>SYNOPSIS</h4><blockquote class="synopsis"><div class="box"><code><tt><sup>[<a href="javascript:open_code('BE')">BE</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0"> qalter</tt> <b>[</b><tt>-a</tt> <i>date_time</i><b>][</b><tt>-A</tt><i>account_string</i><b>][</b><tt>-c</tt> <i>interval</i><b>][</b><tt>-e</tt> <i>path_name</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-h</tt> <i>hold_list</i><b>][</b><tt>-j</tt><i>join_list</i><b>][</b><tt>-k</tt> <i>keep_list</i><b>][</b><tt>-l</tt> <i>resource_list</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-m</tt> <i>mail_options</i><b>][</b><tt>-M</tt><i>mail_list</i><b>][</b><tt>-N</tt> <i>name</i><b>][</b><tt>-o</tt> <i>path_name</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-p</tt> <i>priority</i><b>][</b><tt>-r</tt><i>y</i><tt>|</tt><i>n</i><b>][</b><tt>-S</tt> <i>path_name_list</i><b>][</b><tt>-u</tt> <i>user_list</i><b>]<br></b> <tt> </tt> <b></b><i>job_identifier</i> <tt>... <img src="../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div></blockquote><h4><a name="tag_04_106_03"></a>DESCRIPTION</h4><blockquote><p>The attributes of a batch job are altered by a request to the batch server that manages the batch job. The <i>qalter</i> utilityis a user-accessible batch client that requests the alteration of the attributes of one or more batch jobs.</p><p>The <i>qalter</i> utility shall alter the attributes of those batch jobs, and only those batch jobs, for which a batch<i>job_identifier</i> is presented to the utility.</p><p>The <i>qalter</i> utility shall alter the attributes of batch jobs in the order in which the batch <i>job_identifier</i>s arepresented to the utility.</p><p>If the <i>qalter</i> utility fails to process a batch <i>job_identifier</i> successfully, the utility shall proceed to processthe remaining batch <i>job_identifier</i>s, if any.</p><p>For each batch <i>job_identifier</i> for which the <i>qalter</i> utility succeeds, each attribute of the identified batch jobshall be altered as indicated by all the options presented to the utility.</p><p>For each identified batch job for which the <i>qalter</i> utility fails, the utility shall not alter any attribute of the batchjob.</p><p>For each batch job that the <i>qalter</i> utility processes, the utility shall not modify any attribute other than thoserequired by the options and option-arguments presented to the utility.</p><p>The <i>qalter</i> utility shall alter batch jobs by sending a <i>Modify Job Request</i> to the batch server that manages eachbatch job. At the time the <i>qalter</i> utility exits, it shall have modified the batch job corresponding to each successfullyprocessed batch <i>job_identifier</i>. An attempt to alter the attributes of a batch job in the RUNNING state isimplementation-defined.</p></blockquote><h4><a name="tag_04_106_04"></a>OPTIONS</h4><blockquote><p>The <i>qalter</i> utility shall conform to the Base Definitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap12.html#tag_12_02">Section 12.2, Utility Syntax Guidelines</a>.</p><p>The following options shall be supported by the implementation:</p><dl compact><dt><b>-a </b> <i>date_time</i></dt><dd>Redefine the time at which the batch job becomes eligible for execution. <p>The <i>date_time</i> argument shall be in the same form and represent the same time as for the <a href="../utilities/touch.html"><i>touch</i></a> utility. The time so represented shall be set into the <i>Execution_Time</i> attributeof the batch job. If the time specified is earlier than the current time, the <b>-a</b> option shall have no effect.</p></dd><dt><b>-A </b> <i>account_string</i></dt><dd>Redefine the account to which the resource consumption of the batch job should be charged. <p>The syntax of the <i>account_string</i> option-argument is unspecified.</p><p>The <i>qalter</i> utility shall set the <i>Account_Name</i> attribute of the batch job to the value of the <i>account_string</i>option-argument.</p></dd><dt><b>-c </b> <i>interval</i></dt><dd>Redefine whether the batch job should be checkpointed, and if so, how often. <p>The <i>qalter</i> utility shall accept a value for the interval option-argument that is one of the following:</p><dl compact><dt><tt>n</tt></dt><dd>No checkpointing is to be performed on the batch job (NO_CHECKPOINT).</dd><dt><tt>s</tt></dt><dd>Checkpointing is to be performed only when the batch server is shut down (CHECKPOINT_AT_SHUTDOWN).</dd><dt><tt>c</tt></dt><dd>Automatic periodic checkpointing is to be performed at the <i>Minimum_Cpu_Interval</i> attribute of the batch queue, in unitsof CPU minutes (CHECKPOINT_AT_MIN_CPU_INTERVAL).</dd><dt><tt>c</tt>=<i>minutes</i></dt><dd>Automatic periodic checkpointing is to be performed every <i>minutes</i> of CPU time, or every <i>Minimum_Cpu_Interval</i>minutes, whichever is greater. The <i>minutes</i> argument shall conform to the syntax for unsigned integers and shall be greaterthan zero.</dd></dl><p>An implementation may define other checkpoint intervals. The conformance document for an implementation shall describe anyalternative checkpoint intervals, how they are specified, their internal behavior, and how they affect the behavior of theutility.</p><p>The <i>qalter</i> utility shall set the <i>Checkpoint</i> attribute of the batch job to the value of the <i>interval</i>option-argument.</p></dd><dt><b>-e </b> <i>path_name</i></dt><dd>Redefine the path to be used for the standard error stream 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 Std 1003.1-2001, which can be preceded by a host name element ofthe 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>Error_Path</i> attribute of the batch job to the value of the <i>path_name</i> option-argument, including the host name element,if present.</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>Error_Path</i> attribute of the batch job to the value of 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>Error_Path</i> attribute of the batch job to the value of the option-argument without expansion.</p><p>If the <i>path_name</i> option-argument does not include a host name element, the <i>qalter</i> utility shall prefix thepathname in the <i>Error_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>-h </b> <i>hold_list</i></dt><dd>Redefine the types of holds, if any, on the batch job. The <i>qalter</i> <b>-h</b> option shall accept a value for the<i>hold_list</i> option-argument that is a string of alphanumeric characters in the portable character set. <p>The <i>qalter</i> utility shall accept a value for the <i>hold_list</i> option-argument that is a string of one or more of thecharacters <tt>'u'</tt>, <tt>'s'</tt>, or <tt>'o'</tt>, or the single character <tt>'n'</tt>. For each unique character in the<i>hold_list</i> option-argument, the <i>qalter</i> utility shall add a value to the <i>Hold_Types</i> attribute of the batch jobas follows, each representing a different hold type:</p><dl compact><dt><tt>u</tt></dt><dd>USER</dd><dt><tt>s</tt></dt><dd>SYSTEM</dd><dt><tt>o</tt></dt><dd>OPERATOR</dd></dl><p>If any of these characters are duplicated in the <i>hold_list</i> option-argument, the duplicates shall be ignored. An existing<i>Hold_Types</i> attribute can be cleared by the hold type:</p><dl compact><dt><tt>n</tt></dt><dd>NO_HOLD</dd></dl><p>The <i>qalter</i> utility shall consider it an error if any hold type other than <tt>'n'</tt> is combined with hold type<tt>'n'</tt>. Strictly conforming applications shall not repeat any of the characters <tt>'u'</tt>, <tt>'s'</tt>, <tt>'o'</tt>,or <tt>'n'</tt> within the <i>hold_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 hold types. The conformancedocument for an implementation shall describe any additional hold types, how they are specified, their internal behavior, and howthey affect the behavior of the utility.</p></dd><dt><b>-j </b> <i>join_list</i></dt><dd>Redefine which streams of the batch job are to be merged. The <i>qalter</i> <b>-j</b> option shall accept a value for the<i>join_list</i> option-argument that is a string of alphanumeric characters in the portable character set. <p>The <i>qalter</i> utility shall accept a <i>join_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>All of the other batch job output streams specified shall be merged into the output stream represented by the character listedfirst in the <i>join_list</i> option-argument.</p><p>For each unique character in the <i>join_list</i> option-argument, the <i>qalter</i> utility shall add a value to the<i>Join_Path</i> attribute of the batch job as follows, each representing a different batch job stream to join:</p><dl compact><dt><tt>e</tt></dt><dd>The standard error of the batch job (JOIN_STD_ERROR).</dd><dt><tt>o</tt></dt><dd>The standard output of the batch job (JOIN_STD_OUTPUT).</dd></dl><p>An existing <i>Join_Path</i> attribute can be cleared by the join type:</p><dl compact><dt><tt>n</tt></dt><dd>NO_JOIN</dd></dl><p>If <tt>'n'</tt> is specified, then no files are joined. The <i>qalter</i> utility shall consider it an error if any join typeother than <tt>'n'</tt> is combined with join 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>join_list</i> option-argument. The <i>qalter</i> utility shall permit the repetition of characters, but shall not assignadditional meaning to the repeated characters.</p><p>An implementation may define other join types. The conformance document for an implementation shall describe any additionalbatch job streams, how they are specified, their internal behavior, and how they affect the behavior of the utility.</p></dd><dt><b>-k </b> <i>keep_list</i></dt>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -