NAME

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

SYNTAX

       qrstat [-ar ar_id,...]  [-help] [-u user,...]  [-explain]

DESCRIPTION

       qrstat  shows  the  current status of the available Sun Grid Engine ARs.  The selection option -ar 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 $SGE_ROOT/$SGE_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.

OPTIONS

       -ar ar_id,...
              Prints various information about the ARs identified by given ar_id list.

       -explain
              Displays the reason for the error state of an AR. Possible reasons are the unknown state of a host
              or queue instance.

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

       -help  Prints a listing of all options.

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

              The  string   $user  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 "-u $user".

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

OUTPUT FORMATS

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

   Advance Reservation Summary (without -ar)
       Following the header line, a section for each AR is provided. The columns contain information for

       •  the AR id.

       •  the name of the AR.

       •  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

       •  the start time of the AR.

       •  the end time of the AR.

       •  the duration of the AR.

   Detailed Format (with -ar)
       The  output  contains  two  columns.  The  first  one  contains  all  AR  attributes.  The second one the
       corresponding value.

ENVIRONMENTAL VARIABLES

       SGE_ROOT       Specifies the location of the Sun Grid Engine standard configuration files.

       SGE_CELL       If set, specifies the default Sun Grid Engine cell. To address  a  Sun  Grid  Engine  cell
                      qrstat 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
                       Sun Grid Engine master host file
       <sge_root>/<cell>/common/sge_qrstat
                       cluster qrstat default options
       $HOME/.sge_qrstat
                       user qrstat default options

SEE ALSO

       sge_intro(1), qrsub(1), qrdel(1), qsub(1),

COPYRIGHT

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