NAME

       qtask - file format of the qtask file.

DESCRIPTION

       A  qtask  file  defines which commands are submitted to Sun Grid Engine for remote execution by qtcsh(1).
       The qtask file optionally may contain qrsh(1) command-line parameters. These parameters are passed to the
       qrsh(1) command being used by qtcsh to submit the commands.

       A cluster global qtask file defining cluster wide defaults and a  user  specific  qtask  file  eventually
       overriding   and  enhancing  those  definitions  are  supported.  The  cluster  global  file  resides  at
       <sge_root>/<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.

FORMAT

       The  principle  format  of  the  qtask  file  is  that of a tabulated list. Each line starting with a '#'
       character is a comment line. Each line despite comment lines defines a command to be started remotely.

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

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

       An  exclamation  mark  prefixing  the command in the cluster global qtask file prevents overriding by the
       user supplied qtask file.

EXAMPLES

       The following qtask 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 Sun  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.

SEE ALSO

       sge_intro(1), qtcsh(1), qrsh(1).

COPYRIGHT

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

SGE 6.2u5                                            $Date$                                             QTASK(5)