NAME
     sge_execd - Sun Grid Engine job execution agent

SYNOPSIS
     sge_execd [ -help ]

DESCRIPTION
     sge_execd controls the Sun Grid Engine queues local  to  the
     machine  on which sge_execd is running and executes/controls
     the jobs sent from sge_qmaster(8) to be run on these queues.

OPTIONS
  -help
     Prints a listing of all options.

LOAD SENSORS
     If a load sensor is configured for sge_execd via either  the
     global  host  configuration  or  the execution-host-specific
     cluster configuration  (See  sge_conf(5).),  the  executable
     path of the load sensor is invoked by sge_execd on a regular
     basis and delivers one or multiple load figures for the exe-
     cution  host  (e.g.   users currently logged in) or the com-
     plete cluster (e.g.  free  disk  space  on  a  network  wide
     scratch  file  system). The load sensor may be a script or a
     binary executable. In either case its handling of the  STDIN
     and  STDOUT  streams and its control flow must comply to the
     following rules:

     The load sensor must be written as an infinite loop  waiting
     at  a  certain  point  for  input  from STDIN. If the string
     "quit" is read from STDIN,  the  load  sensor  should  exit.
     When  an  end-of-line  is  read  from  STDIN,  a  load  data
     retrieval cycle should start. The load sensor then  performs
     whatever  operation is necessary to compute the desired load
     figures.  At the end of the cycle the load sensor writes the
     result to stdout. The format is as follows:

     o  A load value report starts with a  line  containing  only
        either the word  "start" or the word "begin".

     o  Individual load values are separated by newlines.

     o  Each load value report consists of three parts  separated
        by colons (":") and containing no blanks.

     o  The first part of a load value information is either  the
        name  of  the host for which load is reported or the spe-
        cial name "global".

     o  The second part is the symbolic name of the load value as
        defined  in  the  host  or  global complex list (see com-
        plex(5) for details). If a load  value  is  reported  for
        which no entry in the host or global complex list exists,
        the reported load value is not used.

     o  The third part is the measured load value.

     o  A load value report ends with a line with only  the  word
        "end".

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location of the Sun Grid Engine
                    standard configuration files.

     SGE_CELL       If set, specifies the default Sun Grid Engine
                    cell.  To  address  a  Sun  Grid  Engine cell
                    sge_execd uses (in the order of precedence):

                         The name of the cell  specified  in  the
                         environment  variable SGE_CELL, if it is
                         set.

                         The  name  of  the  default  cell,  i.e.
                         default.


     SGE_DEBUG_LEVEL
                    If  set,  specifies  that  debug  information
                    should  be written to stderr. In addition the
                    level of detail in which debug information is
                    generated is defined.

     SGE_QMASTER_PORT
                    If set,  specifies  the  tcp  port  on  which
                    sge_qmaster(8) is expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map  entry  for the service
                    "sge_qmaster" instead to define that port.

     SGE_EXECD_PORT If set,  specifies  the  tcp  port  on  which
                    sge_execd(8)  is  expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map  entry  for the service
                    "sge_execd" instead to define that port.

RESTRICTIONS
     sge_execd usually is started from root on  each  machine  in
     the  Sun  Grid  Engine pool.  If started by a normal user, a
     spool  directory  must  be  used  to  which  the  user   has
     read/write access. In this case only jobs being submitted by
     that same user are handled correctly by the system.

FILES
     sgepasswd  contains  a  list  of  user  names   and    their
     corresponding  encrypted  passwords. If available, the pass-
     word  file  will  be   used   by  sge_execd. To  change  the
     contents  of  this file please use the sgepasswd command. It
     is not advised to  change that file manually.
     <sge_root>/<cell>/common/configuration
                     Sun Grid Engine global configuration
     <sge_root>/<cell>/common/local_conf/<host>
                     Sun Grid Engine host specific configuration
     <sge_root>/<cell>/spool/<host>
                     Default execution host spool directory
     <sge_root>/<cell>/common/act_qmaster
                     Sun Grid Engine master host file

SEE ALSO
     sge_intro(1), sge_conf(5), complex(5), sge_qmaster(8).

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.