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  glo-
     bal 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 com-
     mands by users.

FORMAT
     The principle format of the qtask file is that  of  a  tabu-
     lated  list.  Each  line  starting with a '#' character is a
     comment line. Each line despite comment lines defines a com-
     mand to be started remotely.

     Definition starts with the  command  name  that  must  match
     exactly  the name as typed in a qtcsh(1) command-line. Path-
     names 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  permis-
     sions.