USERMAPPING(5)                 File Formats Manual                USERMAPPING(5)

       usermapping - user mapping entry file format

       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 description. New user entries can be created and
       existing can be modified via the -aumap, -mumap and -dumap options to

       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.

              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 hostgroup(5).

       This is a typical user mapping entry for a cluster user mapping:

       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.

       qconf(1), hostgroup(5).

       See sge_intro(1) for a full statement of rights and permissions.

                          $Date: 2001/07/20 08:19:16 $            USERMAPPING(5)