Migration validation preferences

These preferences apply to the management of the difference templates between the Pacbase and the local generation. Difference templates are character strings that are deleted or added in the local code. They have no impact on the functional code. Difference templates and regular expressions are grouped into validation types. The regular expressions apply to the difference templates or directly to the differences (entire code lines with a difference). You can specify migration options for each validation type.

As it runs, the migration help writes records in a file that contains the difference templates between the Pacbase generation and the local generation. The complete file path is displayed in the Template file field. By default, this file is named DifferenceBank.xml and is generated in the .metadata directory of your workspace. You can modify its name or path by clicking Browse. The file is generated in your workspace, so it is not stored on the Rational Team Concert™ server. You must then copy it to validate the migration in the Validation manager view from another workspace.

Predefined validation types are provided in the validation.xml file. This file is available from the installation directory of your Rational® Software Delivery Platform, under rpp/migration. To take these validation types into account, click Import and select the entire file path. The list of the validation types are then displayed in the table of the preferences. This table contains the following columns:
  • The first column contains the validation type ranking number. This number is useful to spot the validation type upon the migration validation.
  • The Name column explains the validation type.
  • The Warning column indicates whether the warnings that correspond to the validation types will be displayed in the Problems view. By default, they will not be displayed.
  • The Migration choice column indicates whether the local code will be kept (default option) or replaced by the Pacbase code upon the migration validation.
You can complete the following actions on the validation types:
  • Modify the related options. Select a validation type and select Edit. Modify the options in the wizard that opens then.
  • Add a validation type. Click Add and indicate the options for this new validation type in the wizard that opens then. You must be an expert to complete this task because it can cause migration problems.
  • Remove a validation type. Select a type and click Remove. You must be an expert to complete this task because it can cause migration problems.
  • Change the order of the validation types. Select a type and move it up or down by clicking the corresponding button. If you do not click OK, the initial line numbers are kept. You can then easily revert to the initial order. Changing the order of the lines is not advised because a difference template can be associated with only one validation type. If it is associated with more than one validation type, it is taken into account in the first one only. If you click OK, the numbers are automatically recalculated according to the new positions in the table.

When you click OK, the regular expressions are controlled. If an expression is incorrect, an error message gives details about the error and prevents you from saving as long as the error is not corrected.

When you save, all the generated COBOL files of your workspace are analyzed and migration warnings are set or not set in the Problems view, depending on the preference choice. You can run this task in the background or cancel it

When the task is complete, the recalculated warnings of the migration help are displayed in the Problems view. You can analyze them and remove them to migrate the files.

You can manage the warnings directly in the Problems view. You can also manage them in a more automatic way in the Validation Manager view. To open this view, select Windows > Show view > Other > PDP framework.


Feedback