QRSTAT(1)
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.