QRSTAT(1)                  Grid Engine User Commands                 QRSTAT(1)



NNAAMMEE
       qrstat - show the status of Grid Engine Advance Reservations (AR)

SSYYNNTTAAXX
       qqrrssttaatt [[--aarr aarr__iidd,,......]]  [[--hheellpp]] [[--uu uusseerr,,......]]  [[--eexxppllaaiinn]]

DDEESSCCRRIIPPTTIIOONN
       _q_r_s_t_a_t  shows the current status of the available Grid Engine ARs.  The
       selection option --aarr allows you to get information about specific AR.

       The administrator and the user may define files which can  contain  any
       of  the  options described below. A cluster-wide sge_qrstat file may be
       placed under $GE_ROOT/$GE_CELL/common/sge_qrstat The user private  file
       is  searched  at  the  location  $HOME/.sge_qrstat.  The home directory
       request file has the highest precedence over the cluster  global  file.
       Command  line can be used to override the flags contained in the files.

OOPPTTIIOONNSS
       --aarr aarr__iidd,,......
              Prints various information about the  ARs  identified  by  given
              ar_id list.

       --eexxppllaaiinn
              Displays  the reason for the error state of an AR. Possible rea-
              sons are the unknown state of a host or queue instance.

              The output format for the alarm reasons is one line per  reason.

       --hheellpp  Prints a listing of all options.

       --uu uusseerr,,......
              Display information only for those ARs created by the users from
              the given user list.

              The string  $$uusseerr is a placeholder for the current username.  An
              asterisk  "*"  can  be used as username wildcard to request that
              all users' ARs be displayed. The default value for  this  switch
              is "--uu $$uusseerr".


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

OOUUTTPPUUTT FFOORRMMAATTSS
       Depending  on  the  presence or absence of the --aarr option there are two
       output formats need to be differentiated.

   AAddvvaannccee RReesseerrvvaattiioonn SSuummmmaarryy ((wwiitthhoouutt --aarr))
       Following the header line, a section for each AR is provided. The  col-
       umns contain information for

       +o  the AR id.

       +o  the name of the AR.

       +o  the current state of the AR. One of following states 'wWrEd".

          w - waiting without error
          W - warning (effective - waiting with error)
          r - running
          E - error (effective - running with error)
          d - deleted

       +o  the start time of the AR.

       +o  the end time of the AR.

       +o  the duration of the AR.

   DDeettaaiilleedd FFoorrmmaatt ((wwiitthh --aarr))
       The  output  contains  two  columns.  The  first  one  contains  all AR
       attributes.  The second one the corresponding value.

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

       GGEE__CCEELLLL        If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell _q_r_s_t_a_t uses (in the order  of
                      precedence):

                             The name of the cell specified in the environment
                             variable GE_CELL, if it is set.

                             The name of the default cell, i.e. ddeeffaauulltt.


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

       GGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on which _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
       _<_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
       _<_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_g_e___q_r_s_t_a_t
                      cluster qrstat default options
       _$_H_O_M_E_/_._g_e___q_r_s_t_a_t
                      user qrstat default options

SSEEEE AALLSSOO
       _g_e___i_n_t_r_o(1), _q_r_s_u_b(1), _q_r_d_e_l(1), _q_s_u_b(1),

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



GE 6.2u2                 $Date: 2008/07/19 17:12:57 $                QRSTAT(1)
