    NAME
         sge_aliases - Sun Grid Engine path aliases file format

    DESCRIPTION
         The Sun Grid Engine path aliasing facility provides adminis-
         trators  and users with the means to reflect complicated and
         in-homogeneous  file  system   structures   in   distributed
         environments  (such  as  user home directories mounted under
         different paths on different hosts) and to ensure  that  Sun
         Grid Engine is able to locate the appropriate working direc-
         tories for executing batch jobs.

         There is a system global path aliasing file and a user local
         file.  sge_aliases defines the format of both:

         o  Blank lines and lines with a '#' sign in the first column
            are skipped.

         o  Each line other than a blank line or a line lead  by  '#'
            has  to  contain  four strings separated by any number of
            blanks or tabs.

         o  The first string specifies a source-path,  the  second  a
            submit-host,  the  third an execution-host and the fourth
            the source-path replacement.

         o  Both the submit- and the execution-host entries may  con-
            sist of only a '*' sign which matches any host.

         If the -cwd flag (and only if - otherwise  the  user's  home
         directory  on  the execution host is selected to execute the
         job) to qsub(1) was specified, the path  aliasing  mechanism
         is activated and the files are processed as follows:

         o  After qsub(1) has retrieved the physical current  working
            directory  path, the cluster global path aliasing file is
            read if present. The  user  path  aliases  file  is  read
            afterwards as if it were appended to the global file.

         o  Lines not to be skipped are read from the top of the file
            one  by  one  while  the  translations specified by those
            lines are stored if necessary.

         o  A translation is stored only  if  the  submit-host  entry
            matches  the  host  qsub(1)  is  executed  on  and if the
            source-path forms the initial part either of the  current
            working  directory  or  of  the  source-path replacements
            already stored.

         o  As soon as both files are read the stored  path  aliasing
            information is passed along with the submitted job.

         o  On the execution host, the aliasing information  will  be
            evaluated. The leading part of the current working direc-
            tory will be replaced by the source-path  replacement  if
            the  execution-host  entry  of the path alias matches the
            executing  host.  Note:  The  current  working  directory
            string  will  be changed in this case and subsequent path
            aliases must match the replaced working directory path to
            be applied.

    EXAMPLES
         The following is a simple example of a  path  aliasing  file
         resolving problems with in-homogeneous paths if automount(8)
         is used:

         =====================================================
         # Path Aliasing File
         # src-path   sub-host   exec-host   replacement
         /tmp_mnt/    *          *           /
         # replaces any occurrence of /tmp_mnt/ by /
         # if submitting or executing on any host.
         # Thus paths on nfs server and clients are the same
         =====================================================

    FILES
         <sge_root>/<cell>/common/sge_aliases
                       global aliases file
         $HOME/.sge_aliases   user local aliases file

    SEE ALSO
         sge_intro(1), qsub(1),  Sun  Grid  Engine  Installation  and
         Administration

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