Transformation variables

In each CICS® configuration and migration scheme, you can define transformation variables. You can refer to these variables in the "from" and "to" masks of transformation rules. When CICS Configuration Manager processes the transformation rules, it substitutes the variable references with their values.

Migration schemes can define two values for each variable: a "source" value and a "target" value. CICS configurations can define only a single value for each variable.

The "from" mask of a transformation rule uses the source value in the migration scheme, or the value defined in the source CICS configuration. The "to" mask uses the target value in the migration scheme, or the value defined in the target CICS configuration. If a CICS configuration and a migration scheme define the same variable, the rule uses the value in the CICS configuration.

For example, suppose that your development environment uses version 1.2.0 of a product, but your test environment uses the older version 1.1.0. The data sets for the two versions are stored under different high-level qualifiers, TLA120 and TLA110. When you migrate FILE resource definitions for this product from development to test, you need to adjust their DSNAME attributes to refer to the correct location. To achieve this, you can define a transformation rule with identical "from" and "to" masks, like this:

&HLQ..*

and use a migration scheme that defines HLQ with a source value of TLA110 and a target value of TLA120.

Now suppose that instead of just one test environment, you have two: TESTA and TESTB. TESTB uses the new product version 2.2.0: its data sets are stored under the high-level qualifier TLA220. To handle this, you do not need to change the migration scheme or the transformation rule: you simply define the HLQ variable in the TESTB CICS configuration, and give it the value TLA220. This example is illustrated in the following figure.

Figure 1. Example: using transformation variables
 1 
Values defined in the source and target CICS configurations override values defined in the migration scheme.

Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


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