QSELECT(1)                 Grid Engine User Commands                QSELECT(1)



[1mNAME[0m
       qselect - select queues.

[1mSYNTAX[0m
       [1mqselect  [22m[  [1m-help  [22m] [ [1m-l resource=val,...  [22m] [ [1m-pe pe_name,...  [22m] [ [1m-q[0m
       [1mwc_queue,...  [22m] [ [1m-s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] [22m] [ [1m-U user,...  [22m]

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

[1mOPTIONS[0m
       [1m-help  [22mPrints a listing of all options.

       [1m-l resource[22m[[1m=value[22m],...
              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.

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

       [1m-q wc_queue,...[0m
              Directly specifies the wildcard queue list to be included in the
              output.  This option usually is only meaningful  in  conjunction
              with  another  [4mqselect[24m option to extract a subset of queue names
              from a list given by [1m-q[22m.  Description of [4mwc_queue[24m can  be  found
              in [4msge_types[24m(1).

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

       [1m-U user,...[0m
              Includes the queues to which the specified users have access  in
              the [4mqselect[24m output.

[1mEXAMPLES[0m
       =====================================================

       % 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 [4mandreas[24m and [4mshannon[24m. The
       third command changes the queue  attribute  [4mh_vmem[24m  to  1  Gigabyte  on
       queues  residing  on  Linux  machines (see the [4mqconf[24m(1) manual page for
       details on the [4m-mattr[24m option  and  the  [4mqueue_conf[24m(5)  manual  page  on
       details of queue configuration entries).

[1mENVIRONMENTAL VARIABLES[0m
       [1mSGE_ROOT       [22mSpecifies  the location of the Grid Engine standard con-
                      figuration files.

       [1mSGE_CELL       [22mIf set, specifies  the  default  Grid  Engine  cell.  To
                      address a Grid Engine cell [4mqselect[24m 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. [1mdefault[22m.


       [1mSGE_DEBUG_LEVEL[0m
                      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.

       [1mSGE_QMASTER_PORT[0m
                      If  set,  specifies the tcp port on which [4msge_qmaster[24m(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.

[1mFILES[0m
       [4m<sge_root>/<cell>/common/act_qmaster[0m
                       Grid Engine master host file

[1mSEE ALSO[0m
       [4msge_intro[24m(1), [4mqconf[24m(1), [4mqmod[24m(1), [4mqstat[24m(1), [4mqueue_conf[24m(5),

[1mCOPYRIGHT[0m
       See [4msge_intro[24m(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2006/04/03 19:10:08 $               QSELECT(1)
