← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to doc/htmlman/htmlman1/qselect.html

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
Import upstream version 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/htmlman/htmlman1/qselect.html
 
1
<HTML>
 
2
<BODY BGCOLOR=white>
 
3
<PRE>
 
4
<!-- Manpage converted by man2html 3.0.1 -->
 
5
NAME
 
6
     qselect - select queues.
 
7
 
 
8
SYNTAX
 
9
     qselect [ -help ] [ -l resource=val,... ] [ -pe  pe_name,...
 
10
     ] [ -q wc_queue,... ] [ -s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] ] [
 
11
     -U user,... ]
 
12
 
 
13
DESCRIPTION
 
14
     <I>qselect</I> prints a list of Grid Engine queue names correspond-
 
15
     ing to selection criteria specified in the <I>qselect</I> arguments
 
16
     described below. The output of <I>qselect</I> can be fed into other
 
17
     Grid  Engine commands to apply actions on the selected queue
 
18
     sets. For  example  together  with  the  -<I>mqattr</I>  option  to
 
19
     <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>,  <I>qselect</I> can be used to modify queue attributes on
 
20
     a set of queues.
 
21
 
 
22
OPTIONS
 
23
     -help
 
24
          Prints a listing of all options.
 
25
 
 
26
     -l resource[=value],...
 
27
          Defines the resources to be granted by the queues which
 
28
          should  be  included in the queue list output. Matching
 
29
          is performed on queues based  on  non-mutable  resource
 
30
          availability  information  only. That means load values
 
31
          are always ignored except  the  so-called  static  load
 
32
          values    (i.e.    "arch",   "num_proc",   "mem_total",
 
33
          "swap_total" and "virtual_total") ones. Also consumable
 
34
          utilization is ignored.
 
35
 
 
36
     -pe pe_name,...
 
37
          Includes queues into the output which are  attached  to
 
38
          at  least  one of the parallel environments enlisted in
 
39
          the comma separated option argument.
 
40
 
 
41
     -q wc_queue,...
 
42
          Directly specifies the wildcard expression  queue  list
 
43
          to  be  included  in the output. This option usually is
 
44
          only meaningful in  conjunction  with  another  <I>qselect</I>
 
45
          option  to  extract a subset of queue names from a list
 
46
          given by -q.  Description of <I>wc</I>_<I>queue</I> can be  found  in
 
47
          <B><A HREF="../htmlman1/sge_types.html">sge_types(1)</A></B>.
 
48
 
 
49
     -qs {a|c|d|o|s|u|A|C|D|E|S}
 
50
          This option allows to filter  for  queue  instances  in
 
51
          certain states.
 
52
 
 
53
     -U user,...
 
54
          Includes the queues to which the specified  users  have
 
55
          access in the <I>qselect</I> output.
 
56
 
 
57
EXAMPLES
 
58
     =====================================================
 
59
 
 
60
     % qselect -l arch=linux
 
61
     % qselect -l arch=linux -U andreas,shannon
 
62
     % qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`
 
63
 
 
64
     =====================================================
 
65
 
 
66
     The first example prints the names of those queues  residing
 
67
     on  Linux machines. The second command in addition restricts
 
68
     the output to those queues with access  permission  for  the
 
69
     users  <I>andreas</I>  and  <I>shannon</I>.  The third command changes the
 
70
     queue attribute <I>h</I>_<I>vmem</I> to 1 Gigabyte on queues  residing  on
 
71
     Linux  machines (see the <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B> manual page for details on
 
72
     the -<I>mattr</I> option  and  the  <B><A HREF="../htmlman5/queue_conf.html">queue_conf(5)</A></B>  manual  page  on
 
73
     details of queue configuration entries).
 
74
 
 
75
ENVIRONMENTAL VARIABLES
 
76
     SGE_ROOT       Specifies the location  of  the  Grid  Engine
 
77
                    standard configuration files.
 
78
 
 
79
     SGE_CELL       If set, specifies  the  default  Grid  Engine
 
80
                    cell.  To  address a Grid Engine cell <I>qselect</I>
 
81
                    uses (in the order of precedence):
 
82
 
 
83
                         The name of the cell  specified  in  the
 
84
                         environment  variable SGE_CELL, if it is
 
85
                         set.
 
86
 
 
87
                         The  name  of  the  default  cell,  i.e.
 
88
                         default.
 
89
 
 
90
 
 
91
     SGE_DEBUG_LEVEL
 
92
                    If  set,  specifies  that  debug  information
 
93
                    should  be written to stderr. In addition the
 
94
                    level of detail in which debug information is
 
95
                    generated is defined.
 
96
 
 
97
     SGE_QMASTER_PORT
 
98
                    If set,  specifies  the  tcp  port  on  which
 
99
                    <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B> is expected to listen for com-
 
100
                    munication requests.  Most installations will
 
101
                    use  a  services  map  entry  for the service
 
102
                    "sge_qmaster" instead to define that port.
 
103
 
 
104
FILES
 
105
     &lt;<I>sge</I>_<I>root</I>&gt;/&lt;<I>cell</I>&gt;/<I>common</I>/<I>act</I>_<I>qmaster</I>
 
106
                     Grid Engine master host file
 
107
 
 
108
 
 
109
SEE ALSO
 
110
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>, <B><A HREF="../htmlman1/qmod.html">qmod(1)</A></B>, <B><A HREF="../htmlman1/qstat.html">qstat(1)</A></B>, <B><A HREF="../htmlman5/queue_conf.html">queue_conf(5)</A></B>,
 
111
 
 
112
COPYRIGHT
 
113
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
 
114
     sions.
 
115
 
 
116
 
 
117
 
 
118
 
 
119
 
 
120
 
 
121
 
 
122
 
 
123
 
 
124
 
 
125
 
 
126
 
 
127
 
 
128
 
 
129
 
 
130
 
 
131
 
 
132
 
 
133
 
 
134
 
 
135
 
 
136
 
 
137
 
 
138
 
 
139
 
 
140
 
 
141
 
 
142
 
 
143
 
 
144
 
 
145
 
 
146
 
 
147
 
 
148
 
 
149
 
 
150
 
 
151
 
 
152
 
 
153
 
 
154
 
 
155
 
 
156
 
 
157
 
 
158
 
 
159
 
 
160
 
 
161
</PRE>
 
162
<HR>
 
163
<ADDRESS>
 
164
Man(1) output converted with
 
165
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
 
166
</ADDRESS>
 
167
</BODY>
 
168
</HTML>