1QSELECT(1) Grid Engine User Commands QSELECT(1)
2
6 qselect - select queues.
7
9 qselect [ -help ] [ -l resource=val,... ] [ -pe pe_name,... ] [ -q
10 wc_queue,... ] [ -s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] ] [ -U user,... ]
11
13 qselect prints a list of Grid Engine queue names corresponding to
14 selection criteria specified in the qselect arguments described below.
15 The output of qselect can be fed into other Grid Engine commands to
16 apply actions on the selected queue sets. For example together with the
17 -mqattr option to qconf(1), qselect can be used to modify queue
18 attributes on a set of queues.
19
21 -help Prints a listing of all options.
22 -l resource[=value],...
24 Defines the resources to be granted by the queues which should
25 be included in the queue list output. Matching is performed on
26 queues based on non-mutable resource availability information
27 only. That means load values are always ignored except the so-
28 called static load values (i.e. "arch", "num_proc", "mem_total",
29 "swap_total" and "virtual_total") ones. Also consumable utiliza‐
30 tion is ignored. If there are multiple -l resource requests
31 they will be concatenated by a logical AND: a queue needs to
32 offer all resources to be displayed.
33 -pe pe_name,...
35 Includes queues into the output which are attached to at least
36 one of the parallel environments enlisted in the comma separated
37 option argument.
38 -q wc_queue,...
40 Directly specifies the wildcard expression queue list to be
41 included in the output. This option usually is only meaningful
42 in conjunction with another qselect option to extract a subset
43 of queue names from a list given by -q. Description of wc_queue
44 can be found in sge_types(1).
45 -qs {a|c|d|o|s|u|A|C|D|E|S}
47 This option allows to filter for queue instances in certain
48 states.
49 -U user,...
51 Includes the queues to which the specified users have access in
52 the qselect output.
53
55 =====================================================
56 % qselect -l arch=linux
58 % qselect -l arch=linux -U andreas,shannon
59 % qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`
60 =====================================================
62 The first example prints the names of those queues residing on Linux
64 machines. The second command in addition restricts the output to those
65 queues with access permission for the users andreas and shannon. The
66 third command changes the queue attribute h_vmem to 1 Gigabyte on
67 queues residing on Linux machines (see the qconf(1) manual page for
68 details on the -mattr option and the queue_conf(5) manual page on
69 details of queue configuration entries).
70
72 GE_ROOT Specifies the location of the Grid Engine standard con‐
73 figuration files.
74 GE_CELL If set, specifies the default Grid Engine cell. To
76 address a Grid Engine cell qselect uses (in the order of
77 precedence):
78 The name of the cell specified in the environment
80 variable GE_CELL, if it is set.
81 The name of the default cell, i.e. default.
83 GE_DEBUG_LEVEL If set, specifies that debug information should be writ‐
86 ten to stderr. In addition the level of detail in which
87 debug information is generated is defined.
88 GE_QMASTER_PORT
90 If set, specifies the tcp port on which ge_qmaster(8) is
91 expected to listen for communication requests. Most
92 installations will use a services map entry for the ser‐
93 vice "sge_qmaster" instead to define that port.
94
96 <ge_root>/<cell>/common/act_qmaster
97 Grid Engine master host file
98
100 ge_intro(1), qconf(1), qmod(1), qstat(1), queue_conf(5),
101
103 See ge_intro(1) for a full statement of rights and permissions.
104GE 6.2u5 $Date: 2009/05/28 16:09:10 $ QSELECT(1)