Mapping Mainframe Users with AccuRev Users

Before synchronizing mainframe files with AccuRev, you should define user maps for all mainframe users changing files on the mainframe to the corresponding AccuRev user (see the chapter on how to define the AccuRev user).

Based on these defined user maps, the system enables AccuRev to provide the information about who has done the latest changes when a file is synchronized from the mainframe. With this, the AccuRev history support will provide the user for all managed versions with the information who has changed specific records within a file (see AccuRev Annotate function).

Note: The AccuRev supported on demand synchronization process requires a defined user map for the AccuRev and mainframe user who is triggering the on demand synchronization. This user map is generated automatically during the on demand synchronization, if it doesn't exist.
Important: Do not define conflicting user mappings, for example one user map for the mainframe UserA mapped to the AccuRev UserB and another user map for the same mainframe UserA mapped to the AccuRev UserC .

In case you have to create a lot of user mappings you may want to create a script which generates the Enterprise Sync user mappings. To do this create a script which generates an XML file with a format like in the following sample:

<UserMaps>
 <UserMap>
  <name>User Map for usera</name>
  <User>
        <type>DataSource</type>
        <value>AccuRevDS</value>
        <name>usera</name>
  </User>
  <User>
        <type>DataSource</type>
        <value>EndevorDS</value>
        <name>USERB</name>
  </User>
  </UserMap>
  <UserMap>
  ...
  </UserMap>
  ...
</UserMaps>

For activating these generated user map definitions execute the following steps:

  1. Disable any running connections.
  2. Logout from the dashboard.
  3. Create a manual backup of the system's configuration XML file Connect.xml, located here: C:\Users\<winuser>\AppData\Local\Micro Focus\Enterprise Sync\Connect.xml.
  4. Copy the generated XML into the Connect.xml file before the <Authenticators> entry. If the <UserMaps> entries already exist, integrate your generated XML into the existing definitions as required.
  5. Login to the system and verify that the User Maps tab displays all your generated user mappings correctly.