NAME

       sge_intro - Grid Engine, a facility for executing jobs on remote machines

DESCRIPTION

       Grid  Engine  is  a  facility for executing Unix-like batch jobs (shell scripts or binaries) on a pool of
       cooperating CPUs. Jobs are queued and executed remotely according to defined policies.  The CPUs  may  be
       in  desktop  systems,  with  jobs  run on them at times when they would otherwise be idle or only lightly
       loaded. The work load may be distributed according to the (generalized) 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 system to system without user  intervention  on  load
       demand.  In  addition  to  simple batch jobs, interactive jobs and parallel jobs can also be submitted to
       Grid Engine.

USER INTERFACE

       The 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.

       qevent(1)
              qevent provides a means of watching Grid Engine events and acting on jobs finishing.

       qhold(1)
              qhold holds back submitted jobs from execution.

       qhost(1)
              qhost displays status information about Grid Engine execution hosts.

       qlogin(1)
              qlogin initiates a telnet or similar login session with automatic selection of a suitable host.

       qmake(1)
              qmake  is  a  replacement  for the standard Unix make facility. It extends make with an 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 queues, e.g. 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 queues.

       qmon(1)
              qmon provides a Motif command interface to all 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.

       qping(1)
              qping can be used to check the status of Grid Engine daemons.

       qquota(1)
              qquota   provides   a   status   listing   of   all   currently   used   resource   quotas    (see
              sge_resource_quota(5)).

       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 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 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 an advance reservation to 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  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  job
              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 Grid Engine.

       qsub(1)
              qsub is the user interface for submitting a job to 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).

COPYRIGHT

       Copyright: 2008 by Sun Microsystems, Inc.  Parts of the  manual  page  texts  are  Copyright  2011  Univa
       Corporation,  and  various  dates  by  other  contributors.   The manual pages are licensed under the Sun
       Industry Standards Source  License,  like  the  source,  except  where  noted  in  some  files  by  other
       contributors, which are under other free licences noted in their source.