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



[1mNAME[0m
       qrstat - show the status of Grid Engine Advance Reservations (AR)

[1mSYNTAX[0m
       [1mqrstat [-ar ar_id,...]  [-help] [-u user,...]  [-explain][0m

[1mDESCRIPTION[0m
       [4mqrstat[24m  shows the current status of the available Grid Engine ARs.  The
       selection option [1m-ar [22mallows 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.

[1mOPTIONS[0m
       [1m-ar ar_id,...[0m
              Prints various information about the  ARs  identified  by  given
              ar_id list.

       [1m-explain[0m
              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.

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

       [1m-u user,...[0m
              Display information only for those ARs created by the users from
              the given user list.

              The string  [1m$user [22mis 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 "[1m-u $user[22m".


       [1m-xml   [22mThis  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.

[1mOUTPUT FORMATS[0m
       Depending  on  the  presence or absence of the [1m-ar [22moption there are two
       output formats need to be differentiated.

   [1mAdvance Reservation Summary (without -ar)[0m
       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.

   [1mDetailed Format (with -ar)[0m
       The  output  contains  two  columns.  The  first  one  contains  all AR
       attributes.  The second one the corresponding value.

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

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


       [1mGE_DEBUG_LEVEL [22mIf 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.

       [1mGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on which [4mge_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<ge_root>/<cell>/common/act_qmaster[0m
                      Grid Engine master host file
       [4m<ge_root>/<cell>/common/ge_qrstat[0m
                      cluster qrstat default options
       [4m$HOME/.ge_qrstat[0m
                      user qrstat default options

[1mSEE ALSO[0m
       [4mge_intro[24m(1), [4mqrsub[24m(1), [4mqrdel[24m(1), [4mqsub[24m(1),

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



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