deffolder

The deffolder utility imports Folders and SMART Folders into the Control-M/EM database. To run the deffolder utility, see Running the deffolder utility.

When deffolder is invoked, a file of arguments that you have created is processed. This input file contains statements that specify:

• an existing folder or set of folders
• an existing SMART Folder or set of SMART Folders.

For more information, see deffolder XML file rules. The specified folders are imported into the Control-M/EM database.

The deffolder 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 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.

For an example of the two validation processes see emdef validation service error message example.

If the folders do not exist in the Control-M/EM database, the utility creates them. If the folders do exist, a message is issued indicating that the folders already exist (unless the /o switch is specified, in which case the folders are overwritten – the /o switch is described below).

The deffolder utility reads folder and SMART Folder definitions directly from a plain text arguments file (in XML format) instead of reading them from the command line.

A single deffolder input file can contain specifications for both folders and SMART Folders.

NOTE: XML is comprised of elements and attributes. Each element can contain attributes and sub-elements. In the folder that follows, elements are bolded and attributes are italicized.