defjob XML file rules

The job definitions that you create for use with the defjob utility are written in XML format, saved in a text file, and when invoked, its contents are passed to the Control-M/EM databases database. For information about creating XML files, see XML file rules.

The following rules apply to the defjob utility XML file:

• More than one job can be specified in a defjob file.
• The file is case-sensitive.
• Although many parameters are optional, certain parameters are required depending on the option specified for the TASKTYPE parameter. For more information, see What in Control‑M Parameters.
• All parameter values (such as strings or digits) must be enclosed in quotation marks (for example, JOBNAME="Job1").
• 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.
• Condition dates must be specified in mmdd format. Time must be specified in hhmm format.
• A parameter requiring more than one entry can be repeated as many times as necessary. For example, if a job must wait for several prerequisite conditions, specify a separate INCOND parameter for each prerequisite condition.
• Each ON_STMT or ON_STEP parameter must be followed by at least one DO parameter. DO parameters are dependent upon the last ON_STMT or ON_STEP parameter preceding them.
• XML is comprised of elements and attributes. Each element can contain attributes and sub-elements.

  For more information on the XML file parameters for the defjob utility, see defjob XML file parameters, and defjob XML file example.

The following values can have more than one line of text:

• Do Mail Message
• Do Remedy Summary
• Do Remedy Description
• Instream JCL (for z/OS)

The multi-line value is formatted in the following manner:

• A four-digit number that indicates the length of the line
• Text following the number

  EXAMPLE: "0011hello world0012just kidding"--

  If the UseMultiLineNewFormatDisplay system parameter is set to 1, then all the values appear with 
 as line delimiters. If set to 0, or not set at all, then the following values appear as described in the above format.