NAME

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

SYNTAX

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

DESCRIPTION

       qrstat  shows  the  current status of the available 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 the 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 a 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
              schemas used 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 the following letters with the given meaning:

          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.

ENVIRONMENT VARIABLES

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

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