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 Grid Engine  queue  instance  names  corresponding  to  selection
       criteria specified in the arguments described below. The output is of limited use since it
       comprises queue instances rather than cluster queues or hosts.

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 listed in load_parameters(5).  Also consumable
              utilization 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 queue instances in the output to which are attached at least  one  of  the
              parallel environments listed 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(5).

       -qs {a|c|d|o|s|u|A|C|D|E|S}
              This option allows filtering by queue instances in certain states (see qstat(1).)

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

ENVIRONMENT VARIABLES

       SGE_ROOT       Specifies the location of the Grid Engine standard configuration files.

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