📄 qsub.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-2003 The Open Group, All Rights Reserved --><title>qsub</title></head><body bgcolor="white"><script type="text/javascript" language="JavaScript" src="../jscript/codes.js"></script><basefont size="3"> <a name="qsub"></a> <a name="tag_04_116"></a><!-- qsub --> <!--header start--><center><font size="2">The Open Group Base Specifications Issue 6<br>IEEE Std 1003.1, 2003 Edition<br>Copyright © 2001-2003 The IEEE and The Open Group, All Rights reserved.</font></center><!--header end--><hr size="2" noshade><h4><a name="tag_04_116_01"></a>NAME</h4><blockquote>qsub - submit a script</blockquote><h4><a name="tag_04_116_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"> qsub</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>]<br></b> <tt> </tt> <b>[</b><tt>-C</tt> <i>directive_prefix</i><b>][</b><tt>-e</tt><i>path_name</i><b>][</b><tt>-h</tt><b>][</b><tt>-j</tt> <i>join_list</i><b>][</b><tt>-k</tt> <i>keep_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>]<br></b> <tt> </tt> <b>[</b><tt>-o</tt> <i>path_name</i><b>][</b><tt>-p</tt><i>priority</i><b>][</b><tt>-q</tt> <i>destination</i><b>][</b><tt>-r</tt> <i>y</i><tt>|</tt><i>n</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-S</tt> <i>path_name_list</i><b>][</b><tt>-u</tt><i>user_list</i><b>][</b><tt>-v</tt> <i>variable_list</i><b>][</b><tt>-V</tt><b>]<br></b> <tt> </tt> <b>[</b><tt>-z</tt><b>][</b><i>script</i><b>]</b><tt><img src="../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div></blockquote><h4><a name="tag_04_116_03"></a>DESCRIPTION</h4><blockquote><p>To submit a script is to create a batch job that executes the script. A script is submitted by a request to a batch server. The<i>qsub</i> utility is a user-accessible batch client that submits a script.</p><p>Upon successful completion, the <i>qsub</i> utility shall have created a batch job that will execute the submitted script.</p><p>The <i>qsub</i> utility shall submit a script by sending a <i>Queue Job Request</i> to a batch server.</p><p>The <i>qsub</i> utility shall place the value of the following environment variables in the <i>Variable_List</i> attribute ofthe batch job: <i>HOME ,</i> <i>LANG ,</i> <i>LOGNAME ,</i> <i>PATH ,</i> <i>MAIL ,</i> <i>SHELL ,</i> and <i>TZ .</i> The name ofthe environment variable shall be the current name prefixed with the string PBS_O_. <basefont size="2"></p><dl><dt><b>Note:</b></dt><dd>If the current value of the <i>HOME</i> variable in the environment space of the <i>qsub</i> utility is <b>/aa/bb/cc</b>, then<i>qsub</i> shall place <i>PBS_O_HOME =</i> <b>/aa/bb/cc</b> in the <i>Variable_List</i> attribute of the batch job.</dd></dl><basefont size="3"> <p>In addition to the variables described above, the <i>qsub</i> utility shall add the following variables with the indicatedvalues to the variable list:</p><dl compact><dt><i>PBS_O_WORKDIR</i></dt><dd>The absolute path of the current working directory of the <i>qsub</i> utility process.</dd><dt><i>PBS_O_HOST</i></dt><dd>The name of the host on which the <i>qsub</i> utility is running.</dd></dl></blockquote><h4><a name="tag_04_116_04"></a>OPTIONS</h4><blockquote><p>The <i>qsub</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>Define the time at which a batch job becomes eligible for execution. <p>The <i>qsub</i> utility shall accept an option-argument that conforms to the syntax of the <i>time</i> operand of the <a href="../utilities/touch.html"><i>touch</i></a> utility.<br></p><center><a name="tagtcjh_18"></a><b>Table: Environment Variable Values (Utilities)</b></center><center><table border="1" cellpadding="3" align="center"><tr valign="top"><th align="center"><p class="tent"><b>Variable Name</b></p></th><th align="center"><p class="tent"><b>Value at qsub Time</b></p></th></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_HOME</i></p></td><td align="left"><p class="tent"><i>HOME</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_HOST</i></p></td><td align="left"><p class="tent"><i>Client host name</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_LANG</i></p></td><td align="left"><p class="tent"><i>LANG</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_LOGNAME</i></p></td><td align="left"><p class="tent"><i>LOGNAME</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_PATH</i></p></td><td align="left"><p class="tent"><i>PATH</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_MAIL</i></p></td><td align="left"><p class="tent"><i>MAIL</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_SHELL</i></p></td><td align="left"><p class="tent"><i>SHELL</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_TZ</i></p></td><td align="left"><p class="tent"><i>TZ</i></p></td></tr><tr valign="top"><td align="left"><p class="tent"><i>PBS_O_WORKDIR</i></p></td><td align="left"><p class="tent"><i>Current working directory</i></p></td></tr></table></center><basefont size="2"> <dl><dt><b>Note:</b></dt><dd>The server that initiates execution of the batch job will add other variables to the batch job's environment; see <a href="xcu_chap03.html#tag_03_02_02_01"><i>Batch Job Execution</i></a> .</dd></dl><basefont size="3"> <p>The <i>qsub</i> utility shall set the <i>Execution_Time</i> attribute of the batch job to the number of seconds since the Epochthat is equivalent to the local time expressed by the value of the <i>date_time</i> option-argument. The Epoch is defined in theBase Definitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap03.html#tag_03_149">Section 3.149,Epoch</a>.</p><p>If the <b>-a</b> option is not presented to the <i>qsub</i> utility, the utility shall set the <i>Execution_Time</i> attributeof the batch job to a time (number of seconds since the Epoch) that is earlier than the time at which the utility exits.</p></dd><dt><b>-A </b> <i>account_string</i></dt><dd><br>Define 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>qsub</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><p>If the <b>-A</b> option is not presented to the <i>qsub</i> utility, the utility shall omit the <i>Account_Name</i> attributefrom the attributes of the batch job.</p></dd><dt><b>-c </b> <i>interval</i></dt><dd>Define whether the batch job should be checkpointed, and if so, how often. <p>The <i>qsub</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 shall be performed on the batch job (NO_CHECKPOINT).</dd><dt><tt>s</tt></dt><dd>Checkpointing shall be performed only when the batch server is shut down (CHECKPOINT_AT_SHUTDOWN).</dd><dt><tt>c</tt></dt><dd>Automatic periodic checkpointing shall 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 shall 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>The <i>qsub</i> utility shall set the <i>Checkpoint</i> attribute of the batch job to the value of the <i>interval</i>option-argument.</p><p>If the <b>-c</b> option is not presented to the <i>qsub</i> utility, the utility shall set the <i>Checkpoint</i> attribute ofthe batch job to the single character <tt>'u'</tt> (CHECKPOINT_UNSPECIFIED).</p></dd><dt><b>-C </b> <i>directive_prefix</i></dt><dd><br>Define the prefix that declares a directive to the <i>qsub</i> utility within the script. <p>The <i>directive_prefix</i> is not a batch job attribute; it affects the behavior of the <i>qsub</i> utility.</p><p>If the <b>-C</b> option is presented to the <i>qsub</i> utility, and the value of the <i>directive_prefix</i> option-argument isthe null string, the utility shall not scan the script file for directives. If the <b>-C</b> option is not presented to the<i>qsub</i> utility, then the value of the <i>PBS_DPREFIX</i> environment variable is used. If the environment variable is notdefined, then #PBS encoded in the portable character set is the default.</p></dd><dt><b>-e </b> <i>path_name</i></dt><dd>Define the path to be used for the standard error stream of the batch job. <p>The <i>qsub</i> utility shall accept a <i>path_name</i> option-argument 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>qsub</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.</p><p>If the <i>path_name</i> option-argument constitutes a relative pathname and no host name element is specified, the <i>qsub</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 executing <i>qsub</i>.</p><p>If the <i>path_name</i> option-argument constitutes a relative pathname and a host name element is specified, the <i>qsub</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 withoutexpansion. The host name element shall be included.</p><p>If the <i>path_name</i> option-argument does not include a host name element, the <i>qsub</i> utility shall prefix the pathnamewith <i>hostname</i>:, where <i>hostname</i> is the name of the host upon which the <i>qsub</i> utility is being executed.</p><p>If the <b>-e</b> option is not presented to the <i>qsub</i> utility, the utility shall set the <i>Error_Path</i> attribute ofthe batch job to the host name and path of the current directory of the submitting process and the default filename.</p><p>The default filename for standard error has the following format:</p><pre><i>job_name</i><tt>.e</tt><i>sequence_number</i></pre></dd><dt><b>-h</b></dt><dd>Specify that a USER hold is applied to the batch job. <p>The <i>qsub</i> utility shall set the value of the <i>Hold_Types</i> attribute of the batch job to the value USER.</p><p>If the <b>-h</b> option is not presented to the <i>qsub</i> utility, the utility shall set the <i>Hold_Types</i> attribute ofthe batch job to the value NO_HOLD.</p></dd><dt><b>-j </b> <i>join_list</i></dt><dd>Define which streams of the batch job are to be merged. The <i>qsub</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 (see the BaseDefinitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap06.html#tag_06_01">Section 6.1, PortableCharacter Set</a>). <p>The <i>qsub</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 will 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>qsub</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>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -