QRSTAT(1) General Commands Manual QRSTAT(1) NAME qrstat - show the status of Univa Grid Engine Advance Reservations (AR) SYNTAX qrstat [-ar ar_id,...] [-help] [-si session_id] [-u user,...] [-explain] DESCRIPTION qrstat shows the current status of the available Univa Grid Engine ARs or Standing Reservations (SRs). The selection option -ar allows you to get information about specific AR or SR. 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 rea- sons 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". -si session_id Requests sent by this client to the sge_qmaster(1) daemon will be done as part of the specified session. If the switch is omit- ted or if NONE is specified as session_id then such requests will be executed outside the control of a session. Find more information concerning sessions in session_conf(5). -xml This option can be used with all other options and changes the output to XML. The used schemas are referenced in the XML out- put. The output is printed to stdout. OUTPUT FORMATS Depending on the presence or absence of the -ar option there are two different output formats. Advance Reservation Summary (without -ar) Following the header line, a section for each AR or SR is provided. The columns contain information for o the AR id. o the name of the AR / SR. o the current state of the AR (first AR in case of an SR). One of fol- lowing 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 / SR. o the end time of the AR / SR. o the duration of the AR / SR. o if the given element is a SR or AR. Detailed Format (with -ar) The output contains two columns. The first one contains all AR and SR attributes. The second one the corresponding value. ENVIRONMENTAL VARIABLES SGE_ROOT Specifies the location of the Univa Grid Engine standard configuration files. SGE_CELL If set, specifies the default Univa Grid Engine cell. To address a Univa 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 writ- ten 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 ser- vice "sge_qmaster" instead to define that port. FILES //common/act_qmaster Univa Grid Engine master host file //common/sge_qrstat cluster qrstat default options $HOME/.sge_qrstat user qrstat default options SEE ALSO sge_intro(1), session_conf(5), qrsub(1), qrdel(1), qsub(1), COPYRIGHT See sge_intro(1) for a full statement of rights and permissions. Univa Grid Engine User Commands UGE 8.5.4 QRSTAT(1)