NAME
     qselect - select queues.

SYNTAX
     qselect [ -help ] [ -l resource=val,... ] [ -pe  pe_name,...
     ] [ -q wc_queue,... ] [ -s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] ] [
     -U user,... ]

DESCRIPTION
     qselect prints  a  list  of  Sun  Grid  Engine  queue  names
     corresponding to selection criteria specified in the qselect
     arguments described below. The output of qselect can be  fed
     into  other Sun Grid Engine commands to apply actions on the
     selected queue sets. For example together with  the  -mqattr
     option  to  qconf(1),  qselect  can  be used to modify queue
     attributes on a set of queues.

OPTIONS
     -help
          Prints a listing of all options.

     -l resource[=value],...
          Defines the resources to be granted by the queues which
          should  be  included in the queue list output. Matching
          is performed on queues based  on  non-mutable  resource
          availability  information  only. That means load values
          are always ignored except  the  so-called  static  load
          values    (i.e.    "arch",   "num_proc",   "mem_total",
          "swap_total" and "virtual_total") ones. Also consumable
          utilization  is  ignored.   If  there  are  multiple -l
          resource requests they will be concatenated by a  logi-
          cal  AND:  a  queue  needs to offer all resources to be
          displayed.

     -pe pe_name,...
          Includes queues into the output which are  attached  to
          at  least  one of the parallel environments enlisted in
          the comma separated option argument.

     -q wc_queue,...
          Directly specifies the wildcard expression  queue  list
          to  be  included  in the output. This option usually is
          only meaningful in  conjunction  with  another  qselect
          option  to  extract a subset of queue names from a list
          given by -q.  Description of wc_queue can be  found  in
          sge_types(1).

     -qs {a|c|d|o|s|u|A|C|D|E|S}
          This option allows to filter  for  queue  instances  in
          certain states.

     -U user,...
          Includes the queues to which the specified  users  have
          access in the qselect output.

EXAMPLES
     =====================================================

     % qselect -l arch=linux
     % qselect -l arch=linux -U andreas,shannon
     % qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`

     =====================================================

     The first example prints the names of those queues  residing
     on  Linux machines. The second command in addition restricts
     the output to those queues with access  permission  for  the
     users  andreas  and  shannon.  The third command changes the
     queue attribute h_vmem to 1 Gigabyte on queues  residing  on
     Linux  machines (see the qconf(1) manual page for details on
     the -mattr option  and  the  queue_conf(5)  manual  page  on
     details of queue configuration entries).

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location of the Sun Grid Engine
                    standard configuration files.

     SGE_CELL       If set, specifies the default Sun Grid Engine
                    cell.  To  address  a  Sun  Grid  Engine cell
                    qselect uses (in the order of precedence):

                         The name of the cell  specified  in  the
                         environment  variable SGE_CELL, if it is
                         set.

                         The  name  of  the  default  cell,  i.e.
                         default.


     SGE_DEBUG_LEVEL
                    If  set,  specifies  that  debug  information
                    should  be written to stderr. In addition the
                    level of detail in which debug information is
                    generated is defined.

     SGE_QMASTER_PORT
                    If set,  specifies  the  tcp  port  on  which
                    sge_qmaster(8) is expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map  entry  for the service
                    "sge_qmaster" instead to define that port.

FILES
     <sge_root>/<cell>/common/act_qmaster
                     Sun Grid Engine master host file

SEE ALSO
     sge_intro(1), qconf(1), qmod(1), qstat(1), queue_conf(5),

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.