Provided by: gridengine-common_6.2-4_all bug

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.