IBM Support

Accessing a test database from the ClearQuest Web Java client

Question & Answer


Question

How can I access a test database using the IBM® Rational® ClearQuest® Web client for versions 2003.06.13 through 7.0.x?

Answer

In order to use a database designated as a test database within the ClearQuest Designer, add the parameter "test=1" to the URL. When this is specified, the global toolbar is replaced by a simple text field, which will allow you to type in the name of a test database. The database marked as test in the ClearQuest Designer can then be specified in that field.

An example of the URL would be:

http://localhost/cqweb/login?test=1


Note: This feature was broken in original 7.0.0 release of ClearQuest, but was fixed in version 7.0.0.1 and later.

Alternatively, you can use a URL that includes the schema repository, the logical database name of the test database and a user name and password. The following sample URL uses the same format as the 7.0.x shortcut functionality where values in the '{{ * }}' must be supplied by the user.


http://{{CQ WEB SERVER}}/cqweb/main?command=GenerateMainFrame &service=CQ&schema={{CONNECTION NAME}}&contextid={{DATABASE NAME}} &username={{CQ USERNAME}}&password={{CQ PASSWORD}}&test=1

For example:

http://localhost/cqweb/main?command=GenerateMainFrame&service=CQ &schema=7.0.0&contextid=SAMPL&username=engineer&password=password&test=1

See technote 1136402 for more information on ClearQuest URLs.

Notes:

  • Selecting "Test Work" from the ClearQuest Designer will still open the test database in the ClearQuest native client for Microsoft® Windows®. A request of enhancement exists, RFE RATLC01202361, for an option to change the ClearQuest client that opens upon selecting Test Work in Designer. This feature is available starting in ClearQuest 7.1. See technote 1335125 for more details.
  • These URLs are recognized and converted to a new URL format starting in ClearQuest 7.1.0.2.

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Web Java Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.13;2003.06.14;2003.06.15;2003.06.16;7.0;7.0.0.1;7.0.0.2;7.0.0.3;7.0.0.4;7.0.0.5;7.0.0.6;7.0.0.7;7.0.0.8;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;7.0.1.4;7.0.1.5;7.0.1.6;7.0.1.7","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Designer","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Client - Native Windows","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21178391