Transformation rules

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:

Qualification criteria
Limit the resource definitions to which the rule applies, based on a combination of:
  • Migration scheme name
  • Source and target CICS configuration names
  • Resource definition group, type, and name
  • Whether a specific field in the resource definition has a specific value (this is not necessarily the field that you want to transform)

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.

Field name and from/to masks
Identifies the field to transform, and the mask strings that define the transformation. For example, a "from" mask of SYSDEV.* and a "to" mask of SYSTEST.* transforms a field value of SYSDEV.VSAM.FILEA to SYSTEST.VSAM.FILEA. For details of the masks you can specify, see Defining masks for transformation rules.

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.

Processing option
Specifies what to do when a field matches the qualification criteria, the field name, and the "from" mask:
Transform and continue
Transform the field according to the "to" mask, and allow further transformation by subsequent rules in the set.
Transform and lock field
Transform the field according to the "to" mask, but do not transform the field any further.
Transform and lock record
Transform the field according to the "to" mask, but do not transform the resource definition any further.
Stop migration
Do not migrate this resource definition. Do not process any more transformation rules for this resource definition.

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.


Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ccv-transformation-rules.htm