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



NNAAMMEE
       qselect - select queues.

SSYYNNTTAAXX
       qqsseelleecctt  [  --hheellpp  ] [ --ll rreessoouurrccee==vvaall,,......  ] [ --ppee ppee__nnaammee,,......  ] [ --qq
       wwcc__qquueeuuee,,......  ] [ --ss {{rr||pp||ss||zz||hhuu||hhoo||hhss||hhjj||hhaa||hh}}[[++]] ] [ --UU uusseerr,,......  ]

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

OOPPTTIIOONNSS
       --hheellpp  Prints a listing of all options.

       --ll rreessoouurrccee[==vvaalluuee],...
              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.

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

       --qq wwcc__qquueeuuee,,......
              Directly specifies the wildcard queue list to be included in the
              output.  This option usually is only meaningful  in  conjunction
              with  another  _q_s_e_l_e_c_t option to extract a subset of queue names
              from a list given by --qq.  Description of _w_c___q_u_e_u_e can  be  found
              in _s_g_e___t_y_p_e_s(1).

       --qqss {{aa||cc||dd||oo||ss||uu||AA||CC||DD||EE||SS}}
              This  option  allows  to  filter  for queue instances in certain
              states.

       --UU uusseerr,,......
              Includes the queues to which the specified users have access  in
              the _q_s_e_l_e_c_t output.

EEXXAAMMPPLLEESS
       =====================================================

       % 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 _a_n_d_r_e_a_s and _s_h_a_n_n_o_n. The
       third command changes the queue  attribute  _h___v_m_e_m  to  1  Gigabyte  on
       queues  residing  on  Linux  machines (see the _q_c_o_n_f(1) manual page for
       details on the _-_m_a_t_t_r option  and  the  _q_u_e_u_e___c_o_n_f(5)  manual  page  on
       details of queue configuration entries).

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies  the location of the Grid Engine standard con-
                      figuration files.

       SSGGEE__CCEELLLL       If set, specifies  the  default  Grid  Engine  cell.  To
                      address a Grid Engine cell _q_s_e_l_e_c_t 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. ddeeffaauulltt.


       SSGGEE__DDEEBBUUGG__LLEEVVEELL
                      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.

       SSGGEE__QQMMAASSTTEERR__PPOORRTT
                      If  set,  specifies the tcp port on which _s_g_e___q_m_a_s_t_e_r(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.

FFIILLEESS
       _<_s_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_t___q_m_a_s_t_e_r
                       Grid Engine master host file

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _q_c_o_n_f(1), _q_m_o_d(1), _q_s_t_a_t(1), _q_u_e_u_e___c_o_n_f(5),

CCOOPPYYRRIIGGHHTT
       See _s_g_e___i_n_t_r_o(1) for a full statement of rights and permissions.



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