QTASK(5) Sun Grid Engine File Formats QTASK(5)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 con-
tain 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 defini-
tions 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.
SGE 6.2u5 $Date$ QTASK(5)
Check Out this Related Man Page
SGE_INTRO(1) Sun Grid Engine User Commands SGE_INTRO(1)NAME
sge_intro.1 - a facility for executing UNIX jobs on remote machines
DESCRIPTION
Sun Grid Engine is a facility for executing UNIX batch jobs (shell scripts) on a pool of cooperating workstations. Jobs are queued and exe-
cuted remotely on workstations at times when those workstations would otherwise be idle or only lightly loaded. The work load is distrib-
uted among the workstations in the cluster corresponding to the load situation of each machine and the resource requirements of the jobs.
User level checkpointing programs are supported and a transparent checkpointing mechanism is provided (see sge_ckpt(1)). Checkpointing
jobs migrate from workstation to workstation without user intervention on load demand. In addition to batch jobs, interactive jobs and par-
allel jobs can also be submitted to Sun Grid Engine.
USER INTERFACE
The Sun Grid Engine user interface consists of several programs which are described separately.
qacct(1)
qacct extracts arbitrary accounting information from the cluster logfile.
qalter(1)
qalter changes the characteristics of already submitted jobs.
qconf(1)
qconf provides the user interface for configuring, modifying, deleting and querying queues and the cluster configuration.
qdel(1)
qdel provides the means for a user/operator/manager to cancel jobs.
qhold(1)
qhold holds back submitted jobs from execution.
qhost(1)
qhost displays status information about Sun Grid Engine execution hosts.
qlogin(1)
qlogin initiates a telnet or similar login session with automatic selection of a low loaded and suitable host.
qmake(1)
qmake is a replacement for the standard Unix make facility. It extends make by its ability to distribute independent make steps
across a cluster of suitable machines.
qmod(1)
qmod allows the owner(s) of a queue to suspend and enable all queues associated with his machine (all currently active processes in
this queue are also signaled) or to suspend and enable jobs executing in the owned queues.
qmon(1)
qmon provides a Motif command interface to all Sun Grid Engine functions. The status of all or a private selection of the configured
queues is displayed on-line by changing colors at corresponding queue icons.
qquota(1)
qquota provides a status listing of all currently used resource quotas (see sge_resource_quota(1).)
qresub(1)
qresub creates new jobs by copying currently running or pending jobs.
qrls(1)
qrls releases holds from jobs previously assigned to them e.g. via qhold(1) (see above).
qrdel(1)
qrdel provides the means to cancel advance reservations.
qrsh(1)
qrsh can be used for various purposes such as providing remote execution of interactive applications via Sun Grid Engine comparable
to the standard Unix facility rsh, to allow for the submission of batch jobs which, upon execution, support terminal I/O (stan-
dard/error output and standard input) and terminal control, to provide a batch job submission client which remains active until the
job has finished or to allow for the Sun Grid Engine-controlled remote execution of the tasks of parallel jobs.
qrstat(1)
qrstat provides a status listing of all advance reservations in the cluster.
qrsub(1)
qrsub is the user interface for submitting a advance reservation to Sun Grid Engine.
qselect(1)
qselect prints a list of queue names corresponding to specified selection criteria. The output of qselect is usually fed into other
Sun Grid Engine commands to apply actions on a selected set of queues.
qsh(1) qsh opens an interactive shell (in an xterm(1)) on a low loaded host. Any kind of interactive jobs can be run in this shell.
qstat(1)
qstat provides a status listing of all jobs and queues associated with the cluster.
qtcsh(1)
qtcsh is a fully compatible replacement for the widely known and used Unix C-Shell (csh) derivative tcsh. It provides a command-
shell with the extension of transparently distributing execution of designated applications to suitable and lightly loaded hosts via
Sun Grid Engine.
qsub(1)
qsub is the user interface for submitting a job to Sun Grid Engine.
SEE ALSO sge_ckpt(1), qacct(1), qalter(1), qconf(1), qdel(1), qhold(1), qhost(1), qlogin(1), qmake(1), qmod(1), qmon(1), qresub(1), qrls(1),
qrsh(1), qselect(1), qsh(1), qstat(1), qsub(1), qtcsh(1), Sun Grid Engine Installation Guide, Sun Grid Engine Administration Guide, Sun
Grid Engine User's Guide.
COPYRIGHT
Copyright: 2008 by Sun Microsystems, Inc.
SGE 6.2u5 $Date$ SGE_INTRO(1)