1QSELECT(1)                 Grid Engine User Commands                QSELECT(1)
2
3
4

NAME

6       qselect - select queues.
7

SYNTAX

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

DESCRIPTION

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

OPTIONS

21       -help  Prints a listing of all options.
22
23       -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
34       -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
39       -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
46       -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
50       -U user,...
51              Includes the queues to which the specified users have access  in
52              the qselect output.
53

EXAMPLES

55       =====================================================
56
57       % qselect -l arch=linux
58       % qselect -l arch=linux -U andreas,shannon
59       % qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`
60
61       =====================================================
62
63       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

ENVIRONMENTAL VARIABLES

72       GE_ROOT        Specifies  the location of the Grid Engine standard con‐
73                      figuration files.
74
75       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
79                             The name of the cell specified in the environment
80                             variable GE_CELL, if it is set.
81
82                             The name of the default cell, i.e. default.
83
84
85       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
89       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

FILES

96       <ge_root>/<cell>/common/act_qmaster
97                      Grid Engine master host file
98

SEE ALSO

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.
104
105
106
107GE 6.2u5                 $Date: 2009/05/28 16:09:10 $               QSELECT(1)
Impressum