sge_intro.1

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(5)).  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.



SGE 8.1.3pre                      2011-05-08                      SGE_INTRO(1)