Arguments are used as selection criteria to determine which jobs to copy. Arguments are written to the copydefjob argument file. The arguments files that you create with the copydefjob utility are written in XML format and saved in a text file. Instructions for preparing this file are in XML file rules.
When this file is invoked, job processing definitions are exported from the Control‑M/EM database.
Each parameter that you specify must have a FROM value. This value is used as a search criteria for selecting jobs to copy.
NOTE: The copydefjob utility can use only simple job parameters as search and replace criteria. Complex parameters, such as the name of an In Condition or the degree of urgency of a Do Shout parameter, cannot be used as search criteria or modified with the copydefjob utility.
The following rules apply to the copydefjob utility arguments file:
More than one job can be specified in the arguments file.
The arguments file is case-sensitive.
All parameter values (such as strings or digits) must be enclosed in quotation marks (for example, JOBNAME="Job1").
Only one COPYJOB parameter can be used in an arguments file.
The COPYJOB parameter must contain only one of each job parameter. Many job parameters are optional.
Multiple values can be specified for TO and FROM by using the * wildcard character. For an explanation of how wildcards function in the XML-based utilities, see Wildcards.
If any FROM value contains a * and the corresponding TO value contains a *, the * in the TO value represents the same information the * in the FROM value.
Changing the data center name or the SMART Folder name imports the copy of the job into a data center or SMART Folder different from the one in which the original job was located.
Most job definition parameters are optional. However note the following:
If you specify any parameters, the FROM subparameter is mandatory and the TO subparameter is optional.
If a FROM value is specified without a TO value, it is used as a filter criterion.
If a TO value is specified, it indicates the new value of the parameter.
