Gathering migration metrics

Before you migrate data to IBM® Rational® DOORS® Next Generation, use the Migration Metrics utility in IBM Rational DOORS to gather information on whole projects or selected modules within a project. Metrics information is generated in a new module in the database.

Before you begin

To run the Migration Metrics utility, you must upgrade the IBM Rational DOORS client where you do this task to version 9.6.1.3 or later.

About this task

The OLE, RTF styling, and suffix options are in version 9.6.1.4 and later. The suffix option is removed in version 9.6.1.6 and later. The option for access rights is in version 9.6.1.6 and later. In versions before 9.6.1.6, type system output is created in a CSV file and module data is created in an XML file. In version 9.6.1.6 and later, all output is created in a new metrics module in the Rational DOORS database.

Procedure

  1. Click File > Migration > Migration Metrics.
  2. In the Migration Metrics window, select the project and scope, including all modules or specific modules in the project.
  3. Select any of these options:
    Option Description
    Type System Include details on all system and user attributes.
    Module Data Include a detailed list of properties for each module.
    Access Rights Include a Module Access Rights view in the new metrics module that displays the following information for each module:
    • If the access control list (ACL) is inherited or customized.
    • The default ACL.
    • A customized ACL for user groups, if applicable.
    • A customized ACL for individual users, if applicable.
    ACL options include Read, Modify, Create, Delete, and Administer. For more information, see Access rights.
    OLE Include a count of OLE objects in the object text (ole="n") and in other attributes (oleNotInObjectText="n").
    Important: This option can cause slow performance, depending on the size of the data.
    RTF Styling Include a count of RTF styling in user attributes (rtfNotInPrimaryText="n"). RTF styling includes bold, italic, underline, or other text formatting. User attributes are attributes other than object heading, object text, or object short text.
    Important: This option can cause slow performance, depending on the size of the data.
  4. Enter a path for the Target Folder to specify the location of the new metrics module.
  5. Enter a name for the new metrics module.
  6. Click Go to create the migration metrics module.