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 .