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



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

DDEESSCCRRIIPPTTIIOONN
       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 _s_g_e___c_k_p_t(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.


UUSSEERR IINNTTEERRFFAACCEE
       The Grid Engine user interface consists of several programs  which  are
       described separately.

       _q_a_c_c_t(1)
              _q_a_c_c_t extracts arbitrary accounting information from the cluster
              logfile.

       _q_a_l_t_e_r(1)
              _q_a_l_t_e_r changes the characteristics of already submitted jobs.

       _q_c_o_n_f(1)
              _q_c_o_n_f provides the user interface  for  configuring,  modifying,
              deleting and querying queues and the cluster configuration.

       _q_d_e_l(1)
              _q_d_e_l  provides  the  means for a user/operator/manager to cancel
              jobs.

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

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

       _q_l_o_g_i_n(1)
              _q_l_o_g_i_n  initiates  a  telnet or similar login session with auto-
              matic selection of a low loaded and suitable host.

       _q_m_a_k_e(1)
              _q_m_a_k_e is a replacement for the standard Unix _m_a_k_e  facility.  It
              extends make by its ability to distribute independent make steps
              across a cluster of suitable machines.

       _q_m_o_d(1)
              _q_m_o_d 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.

       _q_m_o_n(1)
              _q_m_o_n 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.

       _q_r_e_s_u_b(1)
              _q_r_e_s_u_b creates new jobs by copying currently running or  pending
              jobs.

       _q_r_l_s(1)
              _q_r_l_s  releases  holds from jobs previously assigned to them e.g.
              via _q_h_o_l_d(1) (see above).

       _q_r_s_h(1)
              _q_r_s_h 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.

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

       _q_s_h(1) _q_s_h opens an interactive shell (in an _x_t_e_r_m(1)) on a low  loaded
              host. Any kind of interactive jobs can be run in this shell.

       _q_s_t_a_t(1)
              _q_s_t_a_t  provides  a status listing of all jobs and queues associ-
              ated with the cluster.

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

       _q_s_u_b(1)
              _q_s_u_b is the user interface for submitting a job to Grid  Engine.

SSEEEE AALLSSOO
       _s_g_e___c_k_p_t(1),   _q_a_c_c_t(1),   _q_a_l_t_e_r(1),   _q_c_o_n_f(1),   _q_d_e_l(1),  _q_h_o_l_d(1),
       _q_h_o_s_t(1), _q_l_o_g_i_n(1), _q_m_a_k_e(1), _q_m_o_d(1),  _q_m_o_n(1),  _q_r_e_s_u_b(1),  _q_r_l_s(1),
       _q_r_s_h(1),  _q_s_e_l_e_c_t(1),  _q_s_h(1), _q_s_t_a_t(1), _q_s_u_b(1), _q_t_c_s_h(1), _G_r_i_d _E_n_g_i_n_e
       _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e_, _G_r_i_d _E_n_g_i_n_e _Q_u_i_c_k  _S_t_a_r_t  _G_u_i_d_e_,
       _G_r_i_d _E_n_g_i_n_e _U_s_e_r_'_s _G_u_i_d_e_.

CCOOPPYYRRIIGGHHTT
       Copyright: 2004 by Sun Microsystems, Inc.



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