    NAME
         sge_shepherd - Grid Engine single job controlling agent

    SYNOPSIS
         sge_shepherd

    DESCRIPTION
         sge_shepherd provides the parent process functionality for a
         single  Grid Engine job.  The parent functionality is neces-
         sary on UNIX systems to retrieve resource usage  information
         (see  getrusage(2))  after  a job has finished. In addition,
         the sge_shepherd forwards signals to the job,  such  as  the
         signals  for  suspension, enabling, termination and the Grid
         Engine checkpointing signal (see sge_ckpt(1) for details).

         The sge_shepherd receives information about the job to start
         from  the  sge_execd(8).  During the execution of the job it
         actually starts up to 5  child  processes.  First  a  prolog
         script if this feature is enabled by the prolog parameter in
         the cluster configuration (see sge_conf(5)).  Then a  paral-
         lel  environment startup script if the job is a parallel job
         (see sge_pe(5) for more information).   Afterwards  the  job
         itself followed by a parallel environment shutdown procedure
         for parallel jobs, and finally an epilog script if requested
         by  the  epilog  parameter in the cluster configuration. The
         prolog and epilog scripts as well as the  parallel  environ-
         ment  startup  and shutdown procedures are to be provided by
         the Grid Engine administration and  are  intended  for  site
         specific  actions  to  be taken prior and after execution of
         the actual user job.

         After the job has finished and the  epilog  script  is  pro-
         cessed,  sge_shepherd  retrieves  resource  usage statistics
         about the job, places them in a job specific subdirectory of
         the  spool  directory  of sge_execd(8) for reporting through
         sge_execd(8) and finishes.

    RESTRICTIONS
         sge_shepherd should not be invoked  manually,  but  only  by
         sge_execd(8).

    FILES
         <execd_spool>/job_dir/<job_id>     job specific directory

    SEE ALSO
         sge_intro(1), sge_conf(5), sge_execd(8).

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