Adding rules

The migration tool provides four types of migration: Java™ migration, BTT definition XML file migration, dse.ini file migration, and JSP file migration. The migration is implemented according to the configured migration rules.

Two series of rule sets are provided: version 4.3 to version 6.1.2 migration rule set and version 5.2 to version 6.1.2 migration rule set. The rule sets are in the $D(RAD)\plugins\com.ibm.btt.tools.migration_6.1.2\config directory. By default, the 4.3 to 6.1.2 rule set is applied.

There are three configuration files for this Rule-based Migration Tool:

If the default rules can not meet your migration needs, you can add new rules and configure them as the migration rules in the Preference setting.

To configure your own migration rules, do the following:
  • Click Window > Preferences... in Rational® Application Developer.
  • In the left panel of the Preferences dialog box, expand BTT, and select Migration.
  • The migration configuration is displayed in the right panel.
  • You have two options for the configuration of the migration rule:
    • Default rule: BTT migration tool provides a default migration rule. If the default rule meets your migration requirements, you can use it directly. If you do not specify any migration rule, the default rule will be used.
    • Self-define rule: If the default rule does not meet your migration requirements, you can define your own migration rule, and then click Browse to locate your own migration file.

The migration tool reports error if the migration rule is configured incorrectly or the rule file is not valid.