    NAME
         usermapping - user mapping entry file format

    DESCRIPTION
         A usermapping entry is used to  define  alias  names  for  a
         cluster  user.  The users name known by the sheduling system
         is called cluster user. If the cluster  name  doesn't  match
         the  user account name on an execution host, the usermapping
         feature can solve the problem.

         Each line in the usermapping entry  file  specifies  a  user
         name and the host(s) where he has an account.

         A list of currently configured user mapping entries  can  be
         displayed  via  the qconf(1) -sumapl option. The contents of
         each enlisted user mapping entry can be shown via the -sumap
         switch.  The  output follows the usermapping format descrip-
         tion. New user entries can be created and  existing  can  be
         modified  via  the  -aumap,  -mumap  and  -dumap  options to
         qconf(1).

    FORMAT
         A user mapping entry contains at least tree parameters:

         cluster_user keyword
              The cluster_user keyword defines the cluster user name.
              The   rest   of   the   textline   after   the  keyword
              "cluster_user" will be taken as cluster user value.

         name The user name on an execution host.

         hostname
              The name of the host where the user specified  in  name
              has an account.  If The first character of the hostname
              is a "@" sign the name is used  to  reference  a  host-
              group(5).

    EXAMPLE
         This is a typical user mapping entry for a cluster user map-
         ping:

         cluster_user office

         alice     wonderland, realworld, @office2

         The entry will map the user office which is defined  in  the
         cluster system to the user alice on the hosts wonderland and
         realworld. The "@" sign is used to reference a  host  group.
         So the user office is mapped to alice on all hosts specified
         in the host group office2. Please see hostgroup(5) to obtain
         for more information about that.

    SEE ALSO
         qconf(1), hostgroup(5).

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