SGE_REQUEST(5)             Grid Engine File Formats             SGE_REQUEST(5)



NNAAMMEE
       sge_request - Grid Engine default request definition file format

DDEESSCCRRIIPPTTIIOONN
       _s_g_e___r_e_q_u_e_s_t  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 _q_s_u_b(1) or _q_s_h(1) command-line are
       considered.  Thus,  the  command-line  and  embedded script options may
       overwrite the settings in the default request  files  (see  _q_s_u_b(1)  or
       _q_s_h(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.

       NNoottee, that the _-_c_l_e_a_r option to _q_s_u_b(1) or _q_s_h(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  _q_s_u_b(1)  or  _q_s_h(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 _q_s_u_b(1) option as
          described in the 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 _q_s_u_b(1) options and thus  are
          not allowed in a default request file.

EEXXAAMMPPLLEESS
       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


FFIILLEESS
       _<_s_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_s_g_e___r_e_q_u_e_s_t
                     global defaults file
       _$_H_O_M_E_/_._s_g_e___r_e_q_u_e_s_t   user private defaults file
       _$_c_w_d_/_._s_g_e___r_e_q_u_e_s_t    cwd directory defaults file

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _q_s_h(1), _q_s_u_b(1), _G_r_i_d _E_n_g_i_n_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _A_d_m_i_n_i_s_t_r_a_-
       _t_i_o_n _G_u_i_d_e

CCOOPPYYRRIIGGHHTT
       See _s_g_e___i_n_t_r_o(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2004/04/19 10:52:10 $           SGE_REQUEST(5)
