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 Univa Grid Engine queue names corresponding to
       selection  criteria specified in the qselect arguments described below.
       The output of qselect can be fed into other Univa 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 utiliza-
              tion  is  ignored.   If  there are multiple -l resource requests
              they will be concatenated by a logical 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`

       SGE_CELL       If set, specifies the default Univa Grid Engine cell. To
                      address  a  Univa  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 writ-
                      ten 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 communication requests.   Most
                      installations will use a services map entry for the ser-
                      vice "sge_qmaster" instead to define that port.

FILES
       <sge_root>/<cell>/common/act_qmaster
                       Univa 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 permissions.



UGE 8.0.0                $Date: 2009/05/28 16:09:10 $               QSELECT(1)

Man(1) output converted with man2html