QTASK(5)                   Grid Engine File Formats                   QTASK(5)



NNAAMMEE
       qtask - file format of the qtask file.

DDEESSCCRRIIPPTTIIOONN
       A  _q_t_a_s_k  file  defines which commands are submitted to Grid Engine for
       remote execution by _q_t_c_s_h(1).  The _q_t_a_s_k file may contain _q_r_s_h(1)  com-
       mand-line  parameters.  These parameters are passed to the _q_r_s_h(1) com-
       mand used by _q_t_c_s_h to submit the commands.

       A cluster global _q_t_a_s_k file defining cluster wide defaults and  a  user
       specific  _q_t_a_s_k  file eventually overriding and enhancing those defini-
       tions   are   supported.   The   cluster   global   file   resides   at
       $SGE_ROOT/$SGE_CELL/common/qtask,  while  the user specific file can be
       found at ~/.qtask. An exclamation mark preceding command definitions in
       the  cluster global can be used by the administrator to deny overriding
       of such commands by users.

FFOORRMMAATT
       The format of the _q_t_a_s_k file is that of a  tabulated  list.  Each  line
       starting with a '#' character is a comment line. Each line despite com-
       ment lines defines a command to be started remotely.

       The definition starts with the command name that must match exactly the
       name  as typed in a _q_t_c_s_h(1) command-line. Pathnames are not allowed in
       _q_t_a_s_k files. Hence absolute or relative pathnames in _q_t_c_s_h(1)  command-
       lines  always  lead  to local execution even if the commands themselves
       are the same as defined in the _q_t_a_s_k files.

       The command name can be followed by  an  arbitrary  number  of  _q_r_s_h(1)
       option arguments which are passed on to _q_r_s_h(1) by _q_t_c_s_h(1).

       An  exclamation  mark prefixing the command in the cluster global _q_t_a_s_k
       file prevents it from being overridden by the user supplied _q_t_a_s_k file.

EEXXAAMMPPLLEESS
       The following _q_t_a_s_k file

              netscape -l a=sol-sparc64 -v DISPLAY=myhost:0
              grep -l h=filesurfer
              verilog -l veri_lic=1

       designates  the applications netscape, grep and verilog for interactive
       remote execution through Grid Engine. Netscape is requested to run only
       on Solaris64 architectures with the DISPLAY environment variable set to
       'myhost:0', grep only runs on the host named 'filesurfer'  and  verilog
       requests  availability  of  a  verilog license in order to get executed
       remotely.

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _q_t_c_s_h(1), _q_r_s_h(1).

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



GE 6.1                   $Date: 2007/07/19 08:17:17 $                 QTASK(5)
