qselect

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



NAME
       qselect - select queues.

SYNTAX
       qselect [ -help ] [ -l resource=val,...  ] [ -pe pe_name,...  ] [ -q
       queue,...  ] [ -U user,...  ]

DESCRIPTION
       qselect prints a list of Grid Engine Enterprise Edition queue names
       corresponding to selection criteria specified in the qselect arguments
       described below. The output of qselect can be fed into other Grid
       Engine Enterprise Edition 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 consumbale
              utilization is ignored.

       -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 queue,...
              Directly specifies the queues 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.

       -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 -mqattr 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 -mqattr option and the queue_conf(5) manual page on
       details of queue configuration entries).

ENVIRONMENTAL VARIABLES
       SGE_ROOT       Specifies the location of the Grid Engine Enterprise
                      Edition standard configuration files.

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

       COMMD_PORT     If set, specifies the tcp port on which sge_commd(8) is
                      expected to listen for communication requests.  Most
                      installations will use a services map entry instead to
                      define that port.

       COMMD_HOST     If set, specifies the host on which the particular
                      sge_commd(8) to be used for Grid Engine Enterprise
                      Edition communication of the qselect client resides.
                      Per default the local host is used.

FILES
       <sge_root>/<cell>/common/act_qmaster
                       Grid Engine Enterprise Edition master host file

SEE ALSO
       sge_intro(1), qconf(1), qmod(1), qstat(1), queue_conf(5), sge_commd(8).

COPYRIGHT
       See sge_intro(1) for a full statement of rights and permissions.



GEEE 5.3                 $Date: 2004/03/04 16:21:11 $               QSELECT(1)