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.