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 rule file according to the following validation versions, which can affect the validation process:
Validation version 1: Enables you to validate the XML rules folder according to the basic validation process in Control-M/EM version 9.0.18 fix pack 2 and below. If you are using scripts that were created in Control-M/EM version 9.0.18 fix pack 2 and below, and parsed the output to search for specific messages, you can add the -vv1 switch for using validation as if it was running in Control-M/EM version 9.0.18 fix pack 2 and below. It is recommended to use this flag for a short time until you update your script to use the new messages format.
Validation version 2: Enables you to validate 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 warning 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.