Managing requirements by using the Requirements Management (RM) application

If you have installed and configured the Engineering Lifecycle Management, you can create requirements and requirement collections in the Quality Management application. You populate and modify the requirements in the Requirement Management application, and then include the requirements and requirement collections in test plans and test cases in the Quality Management application.

Before you begin

If you created requirements in IBM® Engineering Test Management version 2, you must migrate them as described here: Migrating Rational Quality Manager requirements.

About this task

You must have completed the following steps before you can create and manage requirements using the Requirements Management application.

Note: Step 2 is only necessary if a custom program depends on the Rational Quality Manager requirement API, which is deprecated.


  1. Install and configure the Quality Management and Requirements Management applications.
  2. In the Quality Management application advanced properties, complete the User Name and User Password fields:
    1. Click the Admin icon (Administration) in the upper-right portion of the banner, and select Manage Application. The Application Administration – Quality Management (/qm) page opens.
    2. Under Configuration, click Advanced Properties.
    3. Scroll down to the Requirement section, click User Name and enter a new user name. Do not use the default user name of ADMIN. The user name must belong to a user ID that meets the following requirements:
      • Has a Quality Professional or Requirements Management Analyst license
      • Is a member of the RM project area
      • Has JazzAdmins repository group permissions
    4. Click User Password, and enter a new password. Do not use the default password.
    5. If you want to use custom attributes (other than type String) in the requirements project, you must set Enable custom attributes creation to true in Quality Management Advanced Properties.

      Enabling this setting requires an Analysts license for Requirements Management.

    6. At the top of the page, click Save.
  3. Create requirements projects in the Requirements Management application, using the Base project template, as described here: Creating requirements projects.
    Note: If you created the requirements project with a different template, then the template needs to contain the Requirement and the Test Plan Collection artifact types from the Base template.
  4. Create testing projects in the Quality Management application as described here: Creating a project area.
  5. On the Quality Management Application Administration page, associate Requirements Management projects with Quality Management projects.