1QRSTAT(1)                  Grid Engine User Commands                 QRSTAT(1)
2
3
4

NAME

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

SYNTAX

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

DESCRIPTION

12       qrstat  shows the current status of the available Grid Engine ARs.  The
13       selection option -ar allows you to get information about specific AR.
14
15       The administrator and the user may define files which can  contain  any
16       of  the  options described below. A cluster-wide sge_qrstat file may be
17       placed under $GE_ROOT/$GE_CELL/common/sge_qrstat The user private  file
18       is  searched  at  the  location  $HOME/.sge_qrstat.  The home directory
19       request file has the highest precedence over the cluster  global  file.
20       Command line can be used to override the flags contained in the files.
21

OPTIONS

23       -ar ar_id,...
24              Prints  various  information  about  the ARs identified by given
25              ar_id list.
26
27       -explain
28              Displays the reason for the error state of an AR. Possible  rea‐
29              sons are the unknown state of a host or queue instance.
30
31              The output format for the alarm reasons is one line per reason.
32
33       -help  Prints a listing of all options.
34
35       -u user,...
36              Display information only for those ARs created by the users from
37              the given user list.
38
39              The string  $user is a placeholder for the current username.  An
40              asterisk  "*"  can  be used as username wildcard to request that
41              all users' ARs be displayed. The default value for  this  switch
42              is "-u $user".
43
44
45       -xml   This  option  can be used with all other options and changes the
46              output to XML. The used schemas are referenced in the  XML  out‐
47              put. The output is printed to stdout.
48

OUTPUT FORMATS

50       Depending  on  the  presence or absence of the -ar option there are two
51       output formats need to be differentiated.
52
53   Advance Reservation Summary (without -ar)
54       Following the header line, a section for each AR is provided. The  col‐
55       umns contain information for
56
57       ·  the AR id.
58
59       ·  the name of the AR.
60
61       ·  the current state of the AR. One of following states 'wWrEd".
62
63          w - waiting without error
64          W - warning (effective - waiting with error)
65          r - running
66          E - error (effective - running with error)
67          d - deleted
68
69       ·  the start time of the AR.
70
71       ·  the end time of the AR.
72
73       ·  the duration of the AR.
74
75   Detailed Format (with -ar)
76       The  output  contains  two  columns.  The  first  one  contains  all AR
77       attributes.  The second one the corresponding value.
78

ENVIRONMENTAL VARIABLES

80       GE_ROOT        Specifies the location of the Grid Engine standard  con‐
81                      figuration files.
82
83       GE_CELL        If  set,  specifies  the  default  Grid  Engine cell. To
84                      address a Grid Engine cell qrstat uses (in the order  of
85                      precedence):
86
87                             The name of the cell specified in the environment
88                             variable GE_CELL, if it is set.
89
90                             The name of the default cell, i.e. default.
91
92
93       GE_DEBUG_LEVEL If set, specifies that debug information should be writ‐
94                      ten  to stderr. In addition the level of detail in which
95                      debug information is generated is defined.
96
97       GE_QMASTER_PORT
98                      If set, specifies the tcp port on which ge_qmaster(8) is
99                      expected  to  listen  for  communication requests.  Most
100                      installations will use a services map entry for the ser‐
101                      vice "sge_qmaster" instead to define that port.
102

FILES

104       <ge_root>/<cell>/common/act_qmaster
105                      Grid Engine master host file
106       <ge_root>/<cell>/common/ge_qrstat
107                      cluster qrstat default options
108       $HOME/.ge_qrstat
109                      user qrstat default options
110

SEE ALSO

112       ge_intro(1), qrsub(1), qrdel(1), qsub(1),
113

115       See ge_intro(1) for a full statement of rights and permissions.
116
117
118
119GE 6.2u5                 $Date: 2008/07/19 17:12:57 $                QRSTAT(1)
Impressum