SGE_INTRO(1)               Grid Engine User Commands              SGE_INTRO(1)



[1mNAME[0m
       Grid Engine - a facility for executing UNIX jobs on remote machines

[1mDESCRIPTION[0m
       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 other-
       wise 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 [4msge_ckpt[24m(1)).  Checkpointing
       jobs migrate from workstation to workstation without user  intervention
       on  load demand. In addition to batch jobs, interactive jobs and paral-
       lel jobs can also be submitted to Grid Engine.


[1mUSER INTERFACE[0m
       The Grid Engine user interface consists of several programs  which  are
       described separately.

       [4mqacct[24m(1)
              [4mqacct[24m extracts arbitrary accounting information from the cluster
              logfile.

       [4mqalter[24m(1)
              [4mqalter[24m changes the characteristics of already submitted jobs.

       [4mqconf[24m(1)
              [4mqconf[24m provides the user interface  for  configuring,  modifying,
              deleting and querying queues and the cluster configuration.

       [4mqdel[24m(1)
              [4mqdel[24m  provides  the  means for a user/operator/manager to cancel
              jobs.

       [4mqhold[24m(1)
              [4mqhold[24m holds back submitted jobs from execution.

       [4mqhost[24m(1)
              [4mqhost[24m displays status information about  Grid  Engine  execution
              hosts.

       [4mqlogin[24m(1)
              [4mqlogin[24m  initiates  a  telnet or similar login session with auto-
              matic selection of a low loaded and suitable host.

       [4mqmake[24m(1)
              [4mqmake[24m is a replacement for the standard Unix [4mmake[24m  facility.  It
              extends make by its ability to distribute independent make steps
              across a cluster of suitable machines.

       [4mqmod[24m(1)
              [4mqmod[24m allows the owner(s) of a queue to suspend  and  enable  all
              queues  associated  with  his machine (all currently active pro-
              cesses in this queue are also signaled) or to suspend and enable
              jobs executing in the owned queues.

       [4mqmon[24m(1)
              [4mqmon[24m provides a Motif command interface to all Grid Engine func-
              tions. The status of all or a private selection of  the  config-
              ured  queues  is  displayed on-line by changing colors at corre-
              sponding queue icons.

       [4mqresub[24m(1)
              [4mqresub[24m creates new jobs by copying currently running or  pending
              jobs.

       [4mqrls[24m(1)
              [4mqrls[24m  releases  holds from jobs previously assigned to them e.g.
              via [4mqhold[24m(1) (see above).

       [4mqrsh[24m(1)
              [4mqrsh[24m 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 (stan-
              dard/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.

       [4mqselect[24m(1)
              [4mqselect[24m  prints a list of queue names corresponding to specified
              selection criteria. The output of [4mqselect[24m is  usually  fed  into
              other Grid Engine commands to apply actions on a selected set of
              queues.

       [4mqsh[24m(1) [4mqsh[24m opens an interactive shell (in an [4mxterm[24m(1)) on a low  loaded
              host. Any kind of interactive jobs can be run in this shell.

       [4mqstat[24m(1)
              [4mqstat[24m  provides  a status listing of all jobs and queues associ-
              ated with the cluster.

       [4mqtcsh[24m(1)
              [4mqtcsh[24m is a fully compatible replacement for the widely known and
              used  Unix C-Shell ([4mcsh[24m) derivative [4mtcsh[24m. It provides a command-
              shell with the extension of transparently distributing execution
              of  designated applications to suitable and lightly loaded hosts
              via Grid Engine.

       [4mqsub[24m(1)
              [4mqsub[24m is the user interface for submitting a job to Grid  Engine.

[1mSEE ALSO[0m
       [4msge_ckpt[24m(1),   [4mqacct[24m(1),   [4mqalter[24m(1),   [4mqconf[24m(1),   [4mqdel[24m(1),  [4mqhold[24m(1),
       [4mqhost[24m(1), [4mqlogin[24m(1), [4mqmake[24m(1), [4mqmod[24m(1),  [4mqmon[24m(1),  [4mqresub[24m(1),  [4mqrls[24m(1),
       [4mqrsh[24m(1),  [4mqselect[24m(1),  [4mqsh[24m(1), [4mqstat[24m(1), [4mqsub[24m(1), [4mqtcsh[24m(1), [4mGrid[24m [4mEngine[0m
       [4mInstallation[24m [4mand[24m [4mAdministration[24m [4mGuide,[24m [4mGrid[24m [4mEngine[24m [4mQuick[24m  [4mStart[24m  [4mGuide,[0m
       [4mGrid[24m [4mEngine[24m [4mUser's[24m [4mGuide.[0m

[1mCOPYRIGHT[0m
       Copyright: 2004 by Sun Microsystems, Inc.



GE 6.0                   $Date: 2004/05/26 17:37:54 $             SGE_INTRO(1)
