duplicatedefjob XML file rules

The duplicatedefjob utility can use simple job parameters as search and replace criteria. Complex parameters, such as the name of an In Condition parameter or the degree of urgency of a Do Shout parameter, cannot be used as search criteria or modified with the duplicatedefjob utility.

For instructions about preparing this file, see XML file rules.

The following rules apply to the arguments file for the duplicatedefjob utility:

• More than one job can be specified in a duplicatedefjob file.
• The arguments file is case-sensitive.
• All parameter values must be enclosed in quotation marks (for example, JOBNAME="Job1").
• Only one DUPLICATEJOB parameter can be used in the arguments file. This parameter must not contain more than one instance of each job parameter.
• 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 *, and the corresponding TO value contains *, the * in the TO value expresses the same information as the * in the FROM value.
• Changing the data center name or SMART Folder name causes the copy of the job scheduling definition to be imported into the specified data center or SMART Folder.

Most job definition parameters in the arguments file are optional. However, note the following:

• For each parameter that is specified, the FROM subparameter is mandatory and the TO subparameter is optional.
• When FROM is specified without a TO, the FROM value is used as a filter criterion.

  The FROM value is used as a search criteria for selecting jobs to copy. For example, JOBNAME FROM="Job2" copies all jobs with the JobName Job2

• When TO is included, it specifies the value to which the parameter is set. For example, JOBNAME FROM="Job2" TO="Job2B" modifies all jobs with JobName Job2 so that they now have JobName Job2B.

The duplicatedefjob arguments file is checked and processed. If the file contains errors, a message is displayed specifying the lines with the errors.

For more information on the arguments file parameters for the duplicatedefjob utility, see duplicatedefjob XML file parameters, and duplicatedefjob XML file examples.