qtask.5

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.

       Both 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 file can be used by the administrator to deny
       overriding of such commands by users.

FORMAT

       The overall format of the qtask file is that of a tabulated list. Each
       line starting with a '#' character is a comment line. Each non-comment
       line 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 command itself is the
       same as defined in the qtask file.

       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

              firefox -l a=sol-sparc64 -v DISPLAY=myhost:0
              grep -l h=filesurfer
              verilog -l veri_lic=1

       designates the applications firefox, grep and verilog for interactive
       remote execution through Grid Engine. Firefox 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 8.1.3pre             $Date: 2005-03-30 14:31:37 $                 QTASK(5)