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.