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



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

SSYYNNTTAAXX
       qqhhoosstt  [ --FF [rreessoouurrccee__nnaammee,,......]  [ --hheellpp ] [ --hh hhoosstt__lliisstt ] [ --jj ] [ --ll
       rreessoouurrccee==vvaall,,......  ] [ --uu uusseerr,,......  ]

DDEESSCCRRIIPPTTIIOONN
       _q_h_o_s_t 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 _q_h_o_s_t will display a list of all hosts without queue
       or job information.


OOPPTTIIOONNSS
       --FF [ rreessoouurrccee__nnaammee,,...... ]
              _q_h_o_s_t 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 FFuullll FFoorrmmaatt in section OOUUTTPPUUTT  FFOORRMMAATTSS  below
              for further detail.

       --hheellpp  Prints a listing of all options.

       --hh hhoosstt__lliisstt
              Prints a list of all hosts contained in host_list.

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

       --ll rreessoouurrccee[==vvaalluuee],...
              Defines the resources required by the hosts on which information
              is requested.  Matching is performed on hosts.

       --qq     Show  information  about the queues instances hosted by the dis-
              played hosts.

       --uu uusseerr,,......
              Display information only on those jobs and queues being  associ-
              ated with the users from the given user list.

OOUUTTPPUUTT FFOORRMMAATTSS
       Depending  on  the  presence  or  absence of the --qq or --FF and --jj option
       three output formats need to be differentiated.  PP

   DDeeffaauulltt FFoorrmmaatt ((wwiitthhoouutt --qq,, --FF aanndd --jj))
       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 --qq option 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
          _s_g_e___e_x_e_c_d(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 _l_o_a_d___t_h_r_e_s_h_o_l_d_s list of the queue configuration (see _q_u_e_u_e___c_o_n_f(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  _q_u_e_u_e___c_o_n_f(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  _q_m_o_d(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 _c_a_l_e_n_d_a_r___c_o_n_f(5)), while  the  S(ubordinate)  state
       indicates, that the queue has been suspend via subordination to another
       queue (see _q_u_e_u_e___c_o_n_f(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, _s_g_e___e_x_e_c_d(8) on that host
       was  unable  to  locate  the _s_g_e___s_h_e_p_h_e_r_d(8) executable on that host in
       order  to  start  a  job.  Please  check  the  error  logfile  of  that
       _s_g_e___e_x_e_c_d(8) for leads on how to resolve the problem. Please enable the
       queue afterwards via the --cc option of the _q_m_o_d(1) command manually.

       If the --FF option was used, resource availability information is printed
       following  the  host  status line. For each resource (as selected in an
       option argument to --FF or 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
          `gg' - a cluster global,
          `hh' - a host total or

       +o  a second one letter specifier indicating the source for the  current
          resource availability value, being one of
          `ll' - a load value reported for the resource,
          `LL' - a load value for the resource after administrator defined load
          scaling has been applied,
          `cc' - availability derived from the  consumable  resources  facility
          (see _c_o_m_p_l_e_x_e_s(5)),
          `ff'  - 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 --jj) 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
          RReedduucceedd FFoorrmmaatt section 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.

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies the location of the Grid Engine standard  con-
                      figuration files.

       SSGGEE__CCEELLLL       If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell _q_s_t_a_t 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. ddeeffaauulltt.


       SSGGEE__DDEEBBUUGG__LLEEVVEELL
                      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.

       SSGGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on  which  _s_g_e___q_m_a_s_t_e_r(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.

FFIILLEESS
       _<_s_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_t___q_m_a_s_t_e_r
                       Grid Engine master host file

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1),   _q_a_l_t_e_r(1),   _q_c_o_n_f(1),   _q_h_o_l_d(1),  _q_m_o_d(1),  _q_s_t_a_t(1),
       _q_s_u_b(1), _q_u_e_u_e___c_o_n_f(5), _s_g_e___e_x_e_c_d(8), _s_g_e___q_m_a_s_t_e_r(8),  _s_g_e___s_h_e_p_h_e_r_d(8).

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



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