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.