Creating a checksum package for validating modules

Before you export or archive a module, you can create a checksum validation package for it. If you later import or restore the module, you can compare the checksum validation record with the imported or restored module. The comparison is helpful to identify changes to the text or other attribute values in the selected views.

About this task

The checksum feature generates XML files and stores them in a compressed package with a .zip extension. The checksum package identifies a module name, description, and location. The package also lists selected views for the module and the object attributes that are used in those views.

The generated output does not reference links, OLE objects, images, and baselines. The validation compares textual content, but not rich text formatting.

Note: If you create an archive for checksum validation, do not use special characters or non-English-language characters in name of the archive file. The checksum feature cannot compare modules that are restored from archives that include special characters in the file name.

Procedure

  1. In the IBM® Rational® DOORS® desktop client, select a module.
  2. Click Tools > Checksum > Create Checksum.
  3. In the Create Checksum window, select any views that you want to make available for validation.
  4. In the Filename field, type a full path and file name for the checksum compressed file. The file must have a .zip extension.
    Important: Do not include non-English, upper ASCII, or special characters, such as ampersands or exclamation marks, in the checksum file name.
  5. Click Create. After the file is created, click Close.

What to do next

Comparing a checksum package with an imported or restored module

Feedback