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:

       •  The default request files may contain an arbitrary number of lines.   Blank  lines  and
          lines with a '#' sign in the first column are skipped.

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