    NAME
         qtask - file format of the qtask file.

    DESCRIPTION
         A qtask file defines which commands are  submitted  to  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=solaris64 -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.

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

    COPYRIGHT
         See sge_intro(1) for a full statement of rights and  permis-
         sions.