sge_request(5) [debian man page]
SGE_REQUEST(5) Sun Grid Engine File Formats SGE_REQUEST(5) NAME
sge_request - Sun Grid Engine default request definition file format DESCRIPTION
sge_request reflects the format of the files to define default request profiles. If available, default request files are read and processed during job submission before any submit options embedded in the job script and before any options in the qsub(1) or qsh(1) command-line are considered. Thus, the command-line and embedded script options may overwrite the settings in the default request files (see qsub(1) or qsh(1) for details). There is a cluster global, a user private and a working directory local default request definition file. The working directory local default request file has the highest precedence and is followed by the user private and then the cluster global default request file. Note, that the -clear option to qsub(1) or qsh(1) can be used to discard any previous settings at any time in a default request file, in the embedded script flags or in a qsub(1) or qsh(1) command-line option. The format of the default request definition files is: o The default request files may contain an arbitrary number of lines. Blank lines and lines with a '#' sign in the first column are skipped. o Each line not to be skipped may contain any qsub(1) option as described in the Sun Grid Engine Reference Manual. More than one option per line is allowed. The batch script file and argument options to the batch script are not considered as qsub(1) options and thus are not allowed in a default request file. EXAMPLES
The following is a simple example of a default request definition file: ===================================================== # Default Requests File # request group to be sun4 and a CPU-time of 5hr -l arch=sun4,s_cpu=5:0:0 # don't restart the job in case of system crashes -r n ===================================================== Having defined a default request definition file like this and submitting a job as follows: qsub test.sh would have precisely the same effect as if the job was submitted with: qsub -l arch=sun4,s_cpu=5:0:0 -r n test.sh FILES
<sge_root>/<cell>/common/sge_request global defaults file $HOME/.sge_request user private defaults file $cwd/.sge_request cwd directory defaults file SEE ALSO
sge_intro(1), qsh(1), qsub(1), Sun Grid Engine Installation and Administration Guide COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions. SGE 6.2u5 $Date$ SGE_REQUEST(5)
Check Out this Related Man Page
QRSTAT(1) Sun Grid Engine User Commands 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 spe- cific 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 direc- tory 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 prece- dence): 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 infor- mation 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. SGE 6.2u5 $Date$ QRSTAT(1)