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 executed remotely on workstations  at  times
       when  those  workstations would otherwise be idle or only lightly loaded. The work load is
       distributed 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
       parallel 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  (standard/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.