SGE_REQUEST(5)                File Formats Manual               SGE_REQUEST(5)



NAME
       sge_request - Univa 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  dis-
       card  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 Univa 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 submit-
       ting 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),  Univa  Grid  Engine  Installation  and
       Administration Guide

COPYRIGHT
       See sge_intro(1) for a full statement of rights and permissions.



Univa Grid Engine File Formats     UGE 8.5.4                    SGE_REQUEST(5)