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