IBM Support

Restricted Mode occurs in ClearQuest Web, even when licenses are available

Technote (troubleshooting)


This technote explains an issue that occurs when connecting to IBM Rational ClearQuest Web. A "Restricted Mode" message appears. This happens, even though licenses are available and served correctly without a problem.


With fixes introduced by version, the ClearQuest Web application uses a login concatenated with the connection name to fetch a license key from the FlexLM server. Other ClearQuest client applications are using only the login.

Each user login is then defined only once in the Rational optional FlexLm file (rational.opt) when, for example, reserving licenses on the basis of the login with the current behavior of the FLExLM.

Resolving the problem


  1. You can deactivate the Rational.opt file if you do not want to control license usage.
  2. It is necessary for each user to define his login at least twice in the Rational.opt file in the FlexLm server in order to have access to both ClearQuest Web and the others ClearQuest clients. See this example:

    INCLUDE ClearQuest USER admin

    INCLUDE ClearQuest USER admin#CQConnection

This change in the rational.opt file is to take the new user format introduced by ClearQuest Web version

Related information

Setting up the rational.opt file

Cross Reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest Web Java Client

Document information

More support for: Rational ClearQuest

Software version:,,,,,,

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1412398

Modified date: 18 February 2010