Provided by: gridengine-client_8.1.9+dfsg-7build1_amd64 bug

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

SEE ALSO

       sge_intro(1),    qalter(1),    qconf(1),    qhold(1),    qmod(1),    qstat(1),    qsub(1),
       load_parameters(5), queue_conf(5), sge_execd(8), sge_qmaster(8), sge_shepherd(8).

COPYRIGHT

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