    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.