qselect.1




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.



SGE 8.1.3pre                      2012-01-04                        QSELECT(1)

Man(1) output converted with man2html