📄 qselect.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>qselect</title></head><body bgcolor="white"><script type="text/javascript" language="JavaScript" src="../jscript/codes.js"></script><basefont size="3"> <a name="qselect"></a> <a name="tag_04_113"></a><!-- qselect --> <!--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_113_01"></a>NAME</h4><blockquote>qselect - select batch jobs</blockquote><h4><a name="tag_04_113_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"> qselect</tt> <b>[</b><tt>-a</tt> <b>[</b><i>op</i><b>]</b><i>date_time</i><b>][</b><tt>-A</tt><i>account_string</i><b>][</b><tt>-c</tt> <b>[</b><i>op</i><b>]</b><i>interval</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-h</tt> <i>hold_list</i><b>][</b><tt>-l</tt><i>resource_list</i><b>][</b><tt>-N</tt> <i>name</i><b>][</b><tt>-p</tt> <b>[</b><i>op</i><b>]</b><i>priority</i><b>]<br></b> <tt> </tt> <b>[</b><tt>-q</tt> <i>destination</i><b>][</b><tt>-r</tt><i>y</i><tt>|</tt><i>n</i><b>][</b><tt>-s</tt> <i>states</i><b>][</b><tt>-u</tt> <i>user_list</i><b>]</b><tt><img src="../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div></blockquote><h4><a name="tag_04_113_03"></a>DESCRIPTION</h4><blockquote><p>To select a set of batch jobs is to return the batch <i>job_identifier</i>s for each batch job that meets a list of selectioncriteria. A set of batch jobs is selected by a request to a batch server. The <i>qselect</i> utility is a user-accessible batchclient that requests the selection of batch jobs.</p><p>Upon successful completion, the <i>qselect</i> utility shall have returned a list of zero or more batch <i>job_identifier</i>sthat meet the criteria specified by the options and option-arguments presented to the utility.</p><p>The <i>qselect</i> utility shall select batch jobs by sending a <i>Select Jobs Request</i> to a batch server. The <i>qselect</i>utility shall not exit until the server replies to each request generated.</p><p>For each option presented to the <i>qselect</i> utility, the utility shall restrict the set of selected batch jobs as describedin the OPTIONS section.</p><p>The <i>qselect</i> utility shall not restrict selection of batch jobs except by authorization and as required by the optionspresented to the utility.</p><p>When an option is specified with a mandatory or optional <i>op</i> component to the option-argument, then <i>op</i> shallspecify a relation between the value of a certain batch job attribute and the <i>value</i> component of the option-argument. If an<i>op</i> is allowable on an option, then the description of the option letter indicates the <i>op</i> as either mandatory oroptional. Acceptable strings for the <i>op</i> component, and the relation the string indicates, are shown in the followinglist:</p><dl compact><dt><tt>.eq.</tt></dt><dd>The value represented by the attribute of the batch job is equal to the value represented by the option-argument.</dd><dt><tt>.ge.</tt></dt><dd>The value represented by the attribute of the batch job is greater than or equal to the value represented by theoption-argument.</dd><dt><tt>.gt.</tt></dt><dd>The value represented by the attribute of the batch job is greater than the value represented by the option-argument.</dd><dt><tt>.lt.</tt></dt><dd>The value represented by the attribute of the batch job is less than the value represented by the option-argument.</dd><dt><tt>.le.</tt></dt><dd>The value represented by the attribute of the batch job is less than or equal to the value represented by theoption-argument.</dd><dt><tt>.ne.</tt></dt><dd>The value represented by the attribute of the batch job is not equal to the value represented by the option-argument.</dd></dl></blockquote><h4><a name="tag_04_113_04"></a>OPTIONS</h4><blockquote><p>The <i>qselect</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>op</i><b>]</b><i>date_time</i></dt><dd><br>Restrict selection to a specific time, or a range of times. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Execution_Time</i> attribute is related tothe Epoch equivalent of the local time expressed by the value of the <i>date_time</i> component of the option-argument in themanner indicated by the value of the <i>op</i> component of the option-argument.</p><p>The <i>qselect</i> utility shall accept a <i>date_time</i> component of the 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.</p><p>If the <i>op</i> component of the option-argument is not presented to the <i>qselect</i> utility, the utility shall select batchjobs for which the <i>Execution_Time</i> attribute is equal to the <i>date_time</i> component of the option-argument.</p><p>When comparing times, the <i>qselect</i> utility shall use the following definitions for the <i>op</i> component of theoption-argument:</p><dl compact><dt><tt>.eq.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is equal to the time represented by the<i>date_time</i> component of the option-argument.</dd><dt><tt>.ge.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is after or equal to the time representedby the <i>date_time</i> component of the option-argument.</dd><dt><tt>.gt.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is after the time represented by the<i>date_time</i> component of the option-argument.</dd><dt><tt>.lt.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is before the time represented by the<i>date_time</i> component of the option-argument.</dd><dt><tt>.le.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is before or equal to the timerepresented by the <i>date_time</i> component of the option-argument.</dd><dt><tt>.ne.</tt></dt><dd>The time represented by value of the <i>Execution_Time</i> attribute of the batch job is not equal to the time represented bythe <i>date_time</i> component of the option-argument.</dd></dl><p>The <i>qselect</i> utility shall accept the defined character strings for the <i>op</i> component of the option-argument.</p></dd><dt><b>-A </b> <i>account_string</i></dt><dd><br>Restrict selection to the batch jobs charging a specified account. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Account_Name</i> attribute of the batchjob matchs the value of the <i>account_string</i> option-argument.</p><p>The syntax of the <i>account_string</i> option-argument is unspecified.</p></dd><dt><b>-c [</b><i>op</i><b>]</b><i>interval</i></dt><dd><br>Restrict selection to batch jobs within a range of checkpoint intervals. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Checkpoint</i> attribute relates to thevalue of the <i>interval</i> component of the option-argument in the manner indicated by the value of the <i>op</i> component ofthe option-argument.</p><p>If the <i>op</i> component of the option-argument is omitted, the <i>qselect</i> utility shall select batch jobs for which thevalue of the <i>Checkpoint</i> attribute is equal to the value of the <i>interval</i> component of the option-argument.</p><p>When comparing checkpoint intervals, the <i>qselect</i> utility shall use the following definitions for the <i>op</i> componentof the option-argument:</p><dl compact><dt><tt>.eq.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job equals the value of the <i>interval</i> component of theoption-argument.</dd><dt><tt>.ge.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job is greater than or equal to the value of the <i>interval</i>component option-argument.</dd><dt><tt>.gt.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job is greater than the value of the <i>interval</i> componentoption-argument.</dd><dt><tt>.lt.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job is less than the value of the <i>interval</i> componentoption-argument.</dd><dt><tt>.le.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job is less than or equal to the value of the <i>interval</i>component option-argument.</dd><dt><tt>.ne.</tt></dt><dd>The value of the <i>Checkpoint</i> attribute of the batch job does not equal the value of the <i>interval</i> componentoption-argument.</dd></dl><p>The <i>qselect</i> utility shall accept the defined character strings for the <i>op</i> component of the option-argument.</p><p>The ordering relationship for the values of the interval option-argument is defined to be:</p><pre><tt>`n' .gt. `s' .gt. `c=</tt><i>minutes</i><tt>' .ge. `c'</tt></pre>When comparing <i>Checkpoint</i> attributes with an interval having the value of the single character <tt>'u'</tt> , only equalityor inequality are valid comparisons.</dd><dt><b>-h </b> <i>hold_list</i></dt><dd>Restrict selection to batch jobs that have a specific type of hold. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Hold_Types</i> attribute matches the valueof the <i>hold_list</i> option-argument.</p><p>The <i>qselect</i> <b>-h</b> option shall accept a value for the <i>hold_list</i> option-argument that is a string ofalphanumeric characters in the portable character set (see the Base Definitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap06.html#tag_06_01">Section 6.1, Portable Character Set</a>).</p><p>The <i>qselect</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> .</p><p>Each unique character in the <i>hold_list</i> option-argument of the <i>qselect</i> utility is defined as follows, eachrepresenting 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.</p><p>The <i>qselect</i> utility shall consider it an error if any hold type other than <tt>'n'</tt> is combined with hold type<tt>'n'</tt> .</p><p>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>qselect</i> utility shall permit the repetition of characters, butshall not assign additional meaning to the repeated characters.</p><p>An implementation may define other hold types. The conformance document for an implementation shall describe any additional holdtypes, how they are specified, their internal behavior, and how they affect the behavior of the utility.</p></dd><dt><b>-l </b> <i>resource_list</i></dt><dd><br>Restrict selection to batch jobs with specified resource limits and attributes. <p>The <i>qselect</i> utility shall accept a <i>resource_list</i> option-argument with the following syntax:</p><pre><i>resource_name op value</i> <b>[</b><tt>,,</tt><i>resource_name op value</i><tt>,, ...</tt><b>]</b></pre><p>When comparing resource values, the <i>qselect</i> utility shall use the following definitions for the <i>op</i> component ofthe option-argument:</p><dl compact><dt><tt>.eq.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job equals the value of the valuecomponent of the option-argument.</dd><dt><tt>.ge.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job is greater than or equal tothe value of the <i>value</i> component of the option-argument.</dd><dt><tt>.gt.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job is greater than the value ofthe value component of the option-argument.</dd><dt><tt>.lt.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job is less than the value of thevalue component of the option-argument.</dd><dt><tt>.ne.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job does not equal the value ofthe value component of the option-argument.</dd><dt><tt>.le.</tt></dt><dd>The value of the resource of the same name in the <i>Resource_List</i> attribute of the batch job is less than or equal to thevalue of the <i>value</i> component of the option-argument.</dd></dl><p>When comparing the limit of a <i>Resource_List</i> attribute with the <i>value</i> component of the option-argument, if thelimit, the value, or both are non-numeric, only equality or inequality are valid comparisons.</p><p>The <i>qselect</i> utility shall select only batch jobs for which the values of the <i>resource_name</i>s listed in the<i>resource_list</i> option-argument match the corresponding limits of the <i>Resource_List</i> attribute of the batch job.</p><p>Limits of <i>resource_name</i>s present in the <i>Resource_List</i> attribute of the batch job that have no corresponding valuesin the <i>resource_list</i> option-argument shall not be considered when selecting batch jobs.</p></dd><dt><b>-N </b> <i>name</i></dt><dd>Restrict selection to batch jobs with a specified name. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Job_Name</i> attribute matches the valueof the <i>name</i> option-argument. The string specified in the <i>name</i> option-argument shall be passed, uninterpreted, to theserver. This allows an implementation to match "wildcard" patterns against batch job names.</p><p>An implementation shall describe in the conformance document the format it supports for matching against the <i>Job_Name</i>attribute.</p></dd><dt><b>-p [</b><i>op</i><b>]</b><i>priority</i></dt><dd><br>Restrict selection to batch jobs of the specified priority or range of priorities. <p>The <i>qselect</i> utility shall select only batch jobs for which the value of the <i>Priority</i> attribute of the batch jobrelates to the value of the <i>priority</i> component of the option-argument in the manner indicated by the value of the <i>op</i>component of the option-argument.</p><p>If the <i>op</i> component of the option-argument is omitted, the <i>qselect</i> utility shall select batch jobs for which thevalue of the <i>Priority</i> attribute of the batch job is equal to the value of the <i>priority</i> component of theoption-argument.</p><p>When comparing priority values, the <i>qselect</i> utility shall use the following definitions for the <i>op</i> component ofthe option-argument:</p><dl compact><dt><tt>.eq.</tt></dt>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -