IBM Support

License Usage Mapper does not retain settings

Technote (troubleshooting)


Attempts to update the IBM Rational License Usage Mapper in the License Key Administrator result in the changes not being retained after closing.


An example error message is as follows:

Unable to obtain a Rational ClearQuest license; you may need to launch the Rational License Administrator to establish one.
The error reported by the license manager is :
Failed to check out a key for ClearQuest:
FLEXlm Error -18, License server does not support this feature.


This problem is caused by the String Value HKEY_CURRENT_USER\Software\Rational Software\Licensing\1.0\SuiteMap2\Product Name\Choices not being created at install.

Resolving the problem

To correct the issue you must create a String Value in the Microsoft Windows registry.


This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986

  1. Select Start > Run..., type regedit and click OK

  2. In the Microsoft Windows Registry navigate to the following folder:

    HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\

  3. Right click on the Product folder and select New > String Value

  4. Type the name Choices

  5. Double click on Choices a String Value and enter the appropriate Value data you obtain from the license key INCREMENT line in the license file.

    For example:

    INCREMENT UnifyingPlatform rational 1.0 22-JUL-2005 9999 \
    1612907B7D0D \
    VENDOR_STRING="3121-09813|Floating|0|ClearQuest:1.1, RequisitePro:4.0, soda_word:3.5, TestManager:7.1, UnifiedProcess:5.1" \
    vendor_info="|Rational Suite Team Unifying Platform|<B.0.V.>" \
    NOTICE="Rational Startup License" \

    If you had a RequisitePro:4.0 folder in the HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\ directory and you wanted to indicate that IBM Rational RequisitePro can use an IBM Rational Suite Team Unifying Platform license key you would enter UnifyingPlatform:1.0; in the Value data of the Choices String Value.

    Note: The semi-colon needs to end of the Value data.

    Alternatively you can export a HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\ registry key from a working installation to the machine having the problem and import it on the problem system.

    Update: Rational Common Licensing v8.1.

    The String Value for v8.1 is
    HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Licensing\8.0\SuiteMap2

Document information

More support for: Rational License Key Server
License Key Administrator

Software version: 7.0,, 2003.06.13, 2003.06.14, 2003.06.15, 2003.06.16

Operating system(s): Windows

Reference #: 1263952

Modified date: 20 July 2011