Each migration path in a migration scheme can refer to a set of transformation rules. During migration, CICSĀ® Configuration Manager uses these rules to transform candidate resource definitions and any packaged commands that apply to the source CICS configuration of a migration path. Each transformation rule contains three parts:
A transformation rule can apply either to all resource types or to one resource type. A rule that applies to all resource types can refer only to these common fields: GROUP, CHANGETIME, DESCRIPTION, NAME, and USERDATAn. To transform other fields, you must define a separate rule for each resource type.
For lists, you can use the special "field name" of GROUP to transform the names of groups. For example, you can use a "from" mask of *D and a "to" mask of *T to transform a group name in a list from PAYROLLD to PAYROLLT.
CICS Configuration Manager processes transformation rules in the order that the rules appear in the transformation rule set. While each rule can perform only the simple change defined by its "from" and "to" masks, their effect is cumulative. A migrated resource definition might be the result of many transformation rules. The input to the first rule is the candidate as it appears in the source CICS configuration. The input to the second rule is the (possibly transformed) output of the first rule. The input to the third rule is the output of the second rule, and so on, until the last rule in the set is processed, or a rule stops the resource definition from being migrated, or locks a field, or locks the entire record.
Transformation processing is a system option: by default, it is inactive, and transformation rules are ignored. To use transformation rules, you need to activate this system option.