QHOST(1)                   Grid Engine User Commands                  QHOST(1)



[1mNAME[0m
       qhost - show the status of Grid Engine hosts, queues, jobs

[1mSYNTAX[0m
       [1mqhost  [22m[ [1m-F [22m[[1mresource_name,...[22m]  [ [1m-help [22m] [ [1m-h host_list [22m] [ [1m-j [22m] [ [1m-l[0m
       [1mresource=val,...  [22m] [ [1m-u user,...  [22m]

[1mDESCRIPTION[0m
       [4mqhost[24m 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.
       Without any option [4mqhost[24m will display a list of all hosts without queue
       or job information.


[1mOPTIONS[0m
       [1m-F [22m[ [1mresource_name,... [22m]
              [4mqhost[24m 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 [1mFull Format [22min section [1mOUTPUT  FORMATS  [22mbelow
              for further detail.

       [1m-help  [22mPrints a listing of all options.

       [1m-h host_list[0m
              Prints a list of all hosts contained in host_list.

       [1m-j     [22mPrints all jobs running on the queues hosted by the shown hosts.
              This switch calls [1m-q [22mimplicitly.

       [1m-l resource[22m[[1m=value[22m],...
              Defines the resources required by the hosts on which information
              is requested.  Matching is performed on hosts.

       [1m-q     [22mShow  information  about the queues instances hosted by the dis-
              played hosts.

       [1m-u user,...[0m
              Display information only on those jobs and queues being  associ-
              ated with the users from the given user list.

[1mOUTPUT FORMATS[0m
       Depending  on  the  presence  or  absence of the [1m-q [22mor [1m-F [22mand [1m-j [22moption
       three output formats need to be differentiated.  PP

   [1mDefault Format (without -q, -F and -j)[0m
       Following the header line a line is printed for each host consisting of

       +o  the Hostname

       +o  the Architecture.

       +o  the  Number of processors.

       +o  the Load.

       +o  the Total Memory.

       +o  the Used Memory.

       +o  the Total Swapspace.

       +o  the Used Swapspace.

       If the [1m-q [22moption is supplied, each host status line also contains extra
       lines for every queue hosted by the host consisting of,

       +o  the queue name.

       +o  the queue type - one  of  B(atch),  I(nteractive),  C(heckpointing),
          P(arallel), T(ransfer) or combinations thereof,

       +o  the number of used and available job slots,

       +o  the  state  of  the  queue  -  one of u(nknown) if the corresponding
          [4msge_execd[24m(8) cannot be contacted, a(larm), A(larm),  C(alendar  sus-
          pended), s(uspended), S(ubordinate), d(isabled), D(isabled), E(rror)
          or combinations thereof.

       If the state is a(alarm) at least one of the load thresholds defined in
       the [4mload_thresholds[24m list of the queue configuration (see [4mqueue_conf[24m(5))
       is currently exceeded, which prevents from scheduling further  jobs  to
       that queue.

       As  opposed  to  this, the state A(larm) indicates that at least one of
       the suspend thresholds of the queue (see  [4mqueue_conf[24m(5))  is  currently
       exceeded.  This will result in jobs running in that queue being succes-
       sively suspended until no threshold is violated.

       The states s(uspended) and d(isabled) can be  assigned  to  queues  and
       released  via  the  [4mqmod[24m(1)  command. Suspending a queue will cause all
       jobs executing in that queue to be suspended.

       The states D(isabled) and C(alendar suspended) indicate that the  queue
       has  been disabled or suspended automatically via the calendar facility
       of Grid Engine (see [4mcalendar_conf[24m(5)), while  the  S(ubordinate)  state
       indicates, that the queue has been suspend via subordination to another
       queue (see [4mqueue_conf[24m(5) for details). When suspending a queue (regard-
       less  of the cause) all jobs executing in that queue are suspended too.

       If an E(rror) state is displayed for a queue, [4msge_execd[24m(8) on that host
       was  unable  to  locate  the [4msge_shepherd[24m(8) executable on that host in
       order  to  start  a  job.  Please  check  the  error  logfile  of  that
       [4msge_execd[24m(8) for leads on how to resolve the problem. Please enable the
       queue afterwards via the [1m-c [22moption of the [4mqmod[24m(1) command manually.

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

       +o  a  one  letter  specifier  indicating  whether  the current resource
          availability value was dominated by either
          `[1mg[22m' - a cluster global,
          `[1mh[22m' - a host total or

       +o  a second one letter specifier indicating the source for the  current
          resource availability value, being one of
          `[1ml[22m' - a load value reported for the resource,
          `[1mL[22m' - a load value for the resource after administrator defined load
          scaling has been applied,
          `[1mc[22m' - availability derived from the  consumable  resources  facility
          (see [4mcomplexes[24m(5)),
          `[1mf[22m'  - a fixed availability definition derived from a non-consumable
          complex attribute or a fixed resource limit.

       +o  after a colon the name of the resource on which information is  dis-
          played.

       +o  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 Giga-
       byte,  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 [1m-j[22m) a single line is printed
       for each job running currently in this queue. Each job status line con-
       tains

       +o  the job ID,

       +o  the job name,

       +o  the job owner name,

       +o  the   status   of   the  job  -  one  of  t(ransfering),  r(unning),
          R(estarted),  s(uspended),  S(uspended)  or  T(hreshold)  (see   the
          [1mReduced Format [22msection for detailed information),

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

       +o  the priority of the jobs.

[1mENVIRONMENTAL VARIABLES[0m
       [1mSGE_ROOT       [22mSpecifies the location of the Grid Engine standard  con-
                      figuration files.

       [1mSGE_CELL       [22mIf  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell [4mqstat[24m 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. [1mdefault[22m.


       [1mSGE_DEBUG_LEVEL[0m
                      If set, specifies that debug information should be writ-
                      ten  to stderr. In addition the level of detail in which
                      debug information is generated is defined.

       [1mSGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on  which  [4msge_qmaster[24m(8)
                      is  expected to listen for communication requests.  Most
                      installations will use a services map entry for the ser-
                      vice "sge_qmaster" instead to define that port.

[1mFILES[0m
       [4m<sge_root>/<cell>/common/act_qmaster[0m
                       Grid Engine master host file

[1mSEE ALSO[0m
       [4msge_intro[24m(1),   [4mqalter[24m(1),   [4mqconf[24m(1),   [4mqhold[24m(1),  [4mqmod[24m(1),  [4mqstat[24m(1),
       [4mqsub[24m(1), [4mqueue_conf[24m(5), [4msge_execd[24m(8), [4msge_qmaster[24m(8),  [4msge_shepherd[24m(8).

[1mCOPYRIGHT[0m
       See [4msge_intro[24m(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2004/04/19 10:52:00 $                 QHOST(1)
