Ubuntu Manpage: qhost - show the status of Grid Engine hosts, queues, jobs

Provided by: gridengine-client_8.1.9+dfsg-11build3_amd64

NAME

       qhost - show the status of Grid Engine hosts, queues, jobs

SYNTAX

       qhost [-F [resource_name,...]]  [-help] [-h host_list] [-j] [-l resource[=val],...]  [-ncb] [-u user,...]
       [-xml]

DESCRIPTION

       qhost  shows  the  current status of the available Grid Engine hosts, queues and the jobs associated with
       the queues. Selection options allow you to get information about specific hosts, queues, jobs  or  users.
       If  multiple  selections  are done a host is only displayed if all selection criteria for a host are met.
       Without any options qhost will display a list of all hosts without queue or job information.

OPTIONS

-F [resource_name,...]
qhost will present a detailed listing of the current resource availability per host with respect
to all resources (if the option argument is omitted) or with respect to those resources contained
in the resource_name list. Please refer to the description of the Full Format in section OUTPUT
FORMATS below for further detail.

-help Prints a listing of all options.

-h host_list
Prints a list of all hosts contained in host_list.

-j Prints all jobs running on the queues hosted by the shown hosts. This switch calls -q implicitly.

-l resource[=value],...
Defines the resources to be granted by the hosts which should be included in the host list output.
Matching is performed on hosts 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 host needs to match all resources to be
displayed.

-ncb This command line switch can be used in order to get 6.2u5 compatible output with other qhost(1)
command line switches. In that case the output of the corresponding command will suppress
information concerning the execution host topology. Note that this option will be removed in the
next major version.

-q Show information about the queues instances hosted by the displayed hosts.

-u user,...
Display information only on those jobs and queues being associated with the users from the given
user list.

-xml This option can be used with all other options and changes the output to XML. The used schemas are
referenced in the XML output. The output is printed to stdout.

If the -xml parameter is combined with -ncb then the XML output will contain 6.2u5 compatible
output.

OUTPUT FORMATS

       Depending on the presence or absence of the -q or -F and -j  option  three  output  formats  need  to  be
       differentiated.

   Default Format (without -q, -F and -j)
       For each host one line is printed. The output consists of consisting of

       •  the Hostname

       •  the Architecture.

       •  the  Number of processors.

       •  the Load.

       •  the Total Memory.

       •  the Used Memory.

       •  the Total Swapspace.

       •  the Used Swapspace.

       More details can be found in load_parameters(5).

       If  the  -q option is supplied, each host status line also contains extra lines for every queue hosted by
       the host consisting of,

       •  the queue name,

       •  the queue type - one of B(atch), I(nteractive), or a combination thereof,

       •  the number of reserved (by  advance  reservation,  not  resource  reservation),  used  and,  available
          (according to the queue's slots parameter) job slots,

       •  the  state  of  the  queue  -  one  of u(nknown), a(larm), A(larm), C(alendar suspended), s(uspended),
          S(ubordinate), d(isabled), D(isabled), E(rror), (c)configuration ambiguous,  (o)rphaned,  (P)reempted,
          or  some  combinations  thereof.   See section "Full Format" in qstat(1) for explanation of the status
          flags.

       If the -F option was used, resource availability information is printed following the host  status  line.
       For  each  resource  (as selected in an option argument to -F or for all resources if the option argument
       was omitted) a single line is displayed with the following format:

       •  a one letter specifier indicating whether the current resource availability  value  was  dominated  by
          either
          `g' - a cluster global,
          `h' - a host total or

       •  a second one letter specifier indicating the source for the current resource availability value, being
          one of
          `l' - a load value reported for the resource,
          `L' - a load value for the resource after administrator defined load scaling has been applied,
          `c' - availability derived from the consumable resources facility (see complexes(5)),
          `f'  -  a  fixed  availability  definition  derived from a non-consumable complex attribute or a fixed
          resource limit.

       •  after a colon the name of the resource on which information is displayed.

       •  after an equal sign the current resource availability value.

       The displayed availability values and the sources from which they derive are always the minimum values of
       all possible combinations. Hence, for example, a line of the form "qf:h_vmem=4G" indicates that  a  queue
       currently  has  a maximum availability in virtual memory of 4 Gigabyte, where this value is a fixed value
       (e.g. a resource limit in the queue configuration) and it is queue dominated, i.e. the host in total  may
       have  more  virtual  memory  available than this, but the queue doesn't allow for more. Contrarily a line
       "hl:h_vmem=4G" would also indicate an upper bound of 4 Gigabyte  virtual  memory  availability,  but  the
       limit  would be derived from a load value currently reported for the host. So while the queue might allow
       for jobs with higher virtual memory requirements,  the  host  on  which  this  particular  queue  resides
       currently only has 4 Gigabyte available.

       After  the  queue  status line (in case of -j) a single line is printed for each job running currently in
       this queue. Each job status line contains

       •  the job ID,

       •  the job name,

       •  the job owner name,

       •  the status of the job - one of t(ransfering),  r(unning),  R(estarted),  s(uspended),  S(uspended)  or
          T(hreshold) (see the Reduced Format section for detailed information),

       •  the  start  date  and time and the function of the job (MASTER or SLAVE - only meaningful in case of a
          parallel job) and

       •  the priority of the jobs.

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  qhost  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

COPYRIGHT

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

SGE 8.1.3pre                                       2011-12-04                                           QHOST(1)