    NAME
         Grid Engine - a facility for executing UNIX jobs  on  remote
         machines

    DESCRIPTION
         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 situa-
         tion of each machine and the resource  requirements  of  the
         jobs.

         User level checkpointing programs are supported and a  tran-
         sparent    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 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.

         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 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  sig-
              naled)  or  to suspend and enable jobs executing in the
              owned queues.

         qmon(1)
              qmon provides a Motif command  interface  to  all  Grid
              Engine functions. The status of all or a private selec-
              tion of the configured queues is displayed  on-line  by
              changing colors at corresponding queue icons.

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

         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 exe-
              cution, 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.

         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 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  tran-
              sparently distributing execution of designated applica-
              tions 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), Grid Engine Installation and Administra-
         tion Guide, Grid  Engine  Quick  Start  Guide,  Grid  Engine
         User's Guide.

    COPYRIGHT
         Copyright: 2001 by Sun Microsystems, Inc.