Importpromotionrule

The importpromotionrule utility enables you to do the following:

• Perform a mass update on multiple Promotion rules (after Running the exportsitestandards utility) where you can add/update a Promotion rule in a large number of existing Promotion rules, and import them into Control-M.
• Import one or multiple Promotion rules from one environment to another, between two environments on different Control-M/Enterprise Managers. If you import Promotion rules that already exist in the database, you can use the overwrite flag (/o) in the utility command, so existing Promotion rules are replaced. If you do not use the overwrite flag, Promotion rules are not imported and a message is issued that Promotion rules already exist.

Before using the importpromotionrule utility, note the following:

• The Source/Target name must be defined in the Environment Name field in the Promotion Rules tab in Control-M.
• Only one rule for each Source and Target combination is permitted. If the file contains two rules with the same Source and Target, an error message is issued when importing the rule.

The importpromotionrule utility validates the XML rules folder according to the validation process in Control-M/EM version 9.0.19 and above. By adding the switch -vv 2, the utility validates the jobs/folders, which is similar to job/folder validations in Control-M client/Control-M Web. It also validates site standards (includes warnings based on strictness levels), improved error messages descriptions, and updated field names.

NOTE: By default, the utility validates the XML file in accordance with the EmdefValidationVersion system parameter in the CCM (Validation version 2). You can change the value in the CCM without the need to add the switch to the command, which may be preferable if you have many scripts that use a particular validation version.

To run the utility, see Running the importpromotionrule utility.