The first two lines of the arguments file specify the XML version, the text encoding format being used, and the location of the .dtd file.

DUPLICATEJOB

The DUPLICATEJOB tags indicate the start and end of a group of selection criteria for a job or jobs that are to be copied. Only criteria that are located between the DUPLICATEJOB tags are considered to be part of the duplicatedefjob parameters.

FOLDER_NAME

Name of the SMART Folder to which the job belongs. Mandatory.

NOTE: At least one of the following SMART Folder parameters must be included in the arguments file: DATACENTER, FOLDER_NAME, FOLDER_DSN

FOLDER_NAME FROM="Tbl5NYC"

FROM

String. Mandatory

Folder_DSN

(z/OS only). Name of the library that contains the SMART Folder. Mandatory.

NOTE:

• A TO subparameter cannot be specified for this parameter.
• At least one of the following SMART Folder parameters must be included in the arguments file: DATACENTER, FOLDER_NAME, FOLDER_DSN

FOLDER_DSN FROM="Lib1"

FROM

String. Mandatory

DATACENTER

Name of the Control-M installation to which the job belongs. Mandatory.

NOTE:

• A TO parameter cannot be specified for this parameter.
• At least one of the following SMART Folder parameters must be included in the arguments file: DATACENTER, FOLDER_NAME,FOLDER_DSN

  DATACENTER FROM="CTMNYC"

FROM

String. Mandatory.

FOLDER_
ORDER_ METHOD

String. Mandatory.

NOTE: A TO parameter can be specified and modified for this parameter.

FOLDER_ORDER_ METHOD FROM="Job3"

FROM

String. Mandatory.

JOBNAME

Name of the job processing definition. Optional.

JOBNAME FROM="Job3" TO="Job3_COPY"

FROM

Mandatory.

TO

Optional.

FILE_NAME

Name of the file that contains the job script. Optional.

FILE_NAME FROM="Mem3" TO="Mem7"

FROM

Mandatory.

TO

Optional.

SUB_APPLICATION

Name of the group to which the job belongs. Used as a descriptive name for related jobs. Optional.

SUB_APPLICATION FROM="Grp_HR" TO="Grp_ACCT"

FROM

Mandatory.

TO

Optional.

APPLICATION

Name of the application to which the job’s group belongs. Used as a descriptive name for related jobs. Optional.

APPLICATION FROM="App3" TO="App1"

FROM

String. Mandatory.

TO

String Optional.

TASKTYPE

Type of the job (task) to be performed by Control-M. Optional.

TASKTYPE FROM="Detached" TO="Job"

FROM

Mandatory.

Valid values:

• Job
• Detached
• Command
• Dummy

(z/OS only) Valid values:

• Started_Task
• Cyclic_Job
• Cyclic_Task
• Emergency_Job
• Emergency_Cyclic_Job
• Emergency_Task
• Emergency_Cyclic_Task

TO

Optional. Valid values: Same as mandatory FROM values.

(z/OS only) Valid values: Same as z/OS FROM values.

CREATED_BY

Control‑M/EM user who defined the job. String. Optional.

CREATED_BY FROM="emuser" TO="em5"

NOTE: This argument is used by the Control‑M/Server security mechanism. Under certain circumstances, it cannot be modified. For more information, see the Security chapter and the description of the AuthorSecurity system parameter in GUI Server parameters.

FROM

String. Mandatory.

TO

String. Optional.

FILE_PATH

Name of the library/directory in which the job script resides. String. Optional.

FILE_PATH FROM="File1" TO="File4"

FROM

String. Mandatory.

TO

String. Optional.

CMDLINE

Command string supplied when the job Task Type is Command. Optional.

CMDLINE FROM="C:\Format" TO="C\:CD Emnt"

FROM

String. Mandatory.

TO

String. Optional.

HOSTID

Host name of an agent computer or a host group to which the job is submitted. Optional.

HOSTID FROM="Com3" TO="Acct4"

FROM

String. Mandatory.

TO

Host name of the agent computer on which the job copy is running Optional.

RUN_AS

Owner (user ID) associated with the job. This parameter is used by the Control-M/Server security mechanism. Optional.

OWNER FROM="emuser" TO="emhr"

FROM

String. Mandatory.

TO

String. Optional.

MAXRERUN

Maximum number of reruns that can be performed for the job. Optional.

MAXRERUN FROM="1" TO="3"

FROM

String. Mandatory.

TO

String. Optional.

TIMEFROM

Earliest time for submitting the job. Optional.

TIMEFROM FROM="1430" TO="1450"

FROM

String. Mandatory.

TO

String. Optional.

TIMETO

Latest time for submitting the job. Optional.

TIMETO FROM="1600" TO="1620"

FROM

String. Mandatory.

TO

String. Optional.

DUE_OUT

Time that the job is expected to finish. Optional.

DUE_OUT FROM="1500" TO="1530"

FROM

String. Mandatory.

TO

String. Optional.

PRIORITY

Control-M job priority. Optional.

PRIORITY FROM="AA" TO="1A"

FROM

String. Mandatory.

TO

String. Optional.

CRITICAL

Indicates whether the job is a critical-path job in Control-M. Optional.

CRITICAL FROM="0" TO="1"

FROM

Mandatory. Valid values:

• 0 (No. Default)
• 1 (Yes)

TO

Optional. Valid values:

• 0 (No. Default)
• 1 (Yes)

CYCLIC

Indicates whether the job is cyclic (to be run at regular intervals). Optional.

CYCLIC FROM="0" TO="1"

FROM

Mandatory. Valid values:

• 0 (No. Default)
• 1 (Yes)

TO

Optional. Valid values:

• 0 (No. Default)
• 1 (Yes)

CYCLIC_TYPE

Determines the type of cyclic job:

• Interval
• IntervalSequence
• SpecificTimes

CYCLIC_
TOLERANCE

Maximum delay in minutes permitted for a late submission when selecting a specific time (for example 5 minutes).

CYCLIC_INTERVAL_ SEQUENCE

A list of time intervals, separated by commas, (for example +30M,+2H,+1D) up to 4000 characters including commas.

CYCLIC_TIMES_
SEQUENCE

A list of times, separated by commas (for example 0800,1330,2300), which supports time synonym (for example 2730).

CONFIRM

Indicates whether the job must be manually confirmed by the Control‑M/EM user before it runs. Optional.

CONFIRM FROM="0" TO="1"

FROM

Mandatory. Valid values:

• 0 (No. Default)
• 1 (Yes)

TO

Optional. Valid values:

• 0 (No. Default)
• 1 (Yes)

AUTOARCH

Determines whether SYSDATA is to be archived. Optional.

AUTOARCH FROM=0" TO="1"

FROM

Mandatory. Valid values:

• 0 (No. Default)
• 1 (Yes)

TO

Optional. Valid values:

• 0 (No. Default)
• 1 (Yes)

INTERVAL

Length of time (in minutes) to wait between reruns or cyclic runs of a job. Integer. Optional.

INTERVAL FROM="3" TO="4"

FROM

String. Mandatory.

TO

String. Optional.

OVERRIDE_PATH

Name of an alternate job script library/directory. String. Optional.

OVERRIDE PATH FROM="lib3" TO="lib4"

FROM

String. Mandatory.

TO

String. Optional.

MAXWAIT

Number of extra days (after the original scheduling date) that the job is allowed to remain in the Active Jobs database awaiting execution. Integer. Optional.

MAXWAIT FROM="4" TO="3"

FROM

Integer. Mandatory.

TO

Integer. Optional.

DESCRIPTION

Free text description of the job. String. Optional.

DESCRIPTION FROM="data backup from 120399" TO="data backup from 021400"

FROM

String. Mandatory.

TO

String. Optional.

DOCMEM

Name of the file containing job documentation. String. Optional.

DOCMEM FROM="mem4" TO="Mem67"

FROM

String. Mandatory.

TO

String. Optional.

DOCLIB

Name of library or directory containing the job documentation file. String.

Optional.

DOCLIB FROM="AcctFiles" TO="HRFiles"

FROM

String. Mandatory.

TO

String. Optional.

DAYS

Days of the month on which to order the job. String. Optional.

DAYS FROM="ALL" TO="159"

FROM

String. Mandatory.

TO

String. Optional.

DAYS_AND_OR

Relationship between specified Days values and Weekdays values. Optional.

DAYS_AND_OR FROM="AND" TO="OR"

FROM

String. Mandatory.

TO

String. Optional.

WEEKDAYS

Days of the week on which to order the job. String. Optional.

WEEKDAYS FROM="1,2,4" TO="ALL"

FROM

String. Mandatory.

TO

String. Optional.

DATE

Specific dates on which to order the job. String. MMDD format. Optional.

DATE FROM="0312" TO="0319"

FROM

String. Dates are written in mmdd format. Mandatory. There is no delimiter between dates. For example, January 10 is written: DATE="0110."

TO

String. Dates are written in mmdd format. Optional. There is no delimiter between dates. For example, January 10 is written: DATE="0110."

DAYSCAL

User-defined calendar used to specify a set of days. String. Optional.

DAYSCAL FROM="shipping" TO="receiving"

FROM

String. Mandatory.

TO

String. Optional.

WEEKSCAL

Calendar to be used to validate specified weekdays on which to order the job. String. Optional.

WEEKSCAL FROM="w5" TO="w6"

FROM

String. Mandatory.

TO

String. Optional.

CONFCAL

Specifies a calendar that is used to validate all specified days and dates on which to schedule the job. String. Optional.

CONFCAL FROM="cal99" TO="cal00"

FROM

String. Mandatory.

TO

String. Optional.

RETRO

Indicates whether the job is scheduled for possible execution after its original scheduling date (odate) has passed. Optional.

RETRO FROM="0" TO="1"

FROM

Mandatory. Valid values:

• 0 (No. Default)
• 1 (Yes)

TO

Optional. Valid values:

• 0 (No. Default)
• 1 (Yes)

SHIFT

Describes how to shift the scheduling date of the job. Optional.

SHIFT FROM="PREVDAY" TO="NEXTDAY"

FROM

Mandatory. Valid values:

• IGNOREJOB
• PREVDAY
• NEXTDAY
• NOCONFCAL

TO

Optional. Valid values: Same as mandatory FROM values.

SHIFTNUM

Number of days to shift the scheduling date of the job. Optional.

SHIFTNUM FROM="-10" TO="5"

FROM

String. Mandatory.

TO

String. Optional.

MAXDAYS

Maximum number of days to retain the SYSDATA archive dataset for jobs that ended NOTOK. Subparameter of AUTOARCH. String. Optional.

MAXDAYS FROM="07" TO="14"

FROM

String. Mandatory.

TO

String. Optional.

MAXRUNS

Maximum number of job runs to retain the SYSDATA archive dataset for jobs that ended NOTOK. Subparameter of AUTOARCH. String. Optional.

MAXRUNS FROM="100" TO="250"

FROM

String. Mandatory.

TO

String. Optional.

RERUNMEM

(z/OS only) JCL member to use when the job is automatically rerun. String. 1 - 8 characters. Optional.

RERUNMEM FROM="Mem45" TO="Mem7"

FROM

String. Mandatory.

TO

String. Optional.

RETEN_DAYS

(z/OS only) Number of days to retain the job in the History Jobs file. String.

Optional.

RETEN_DAYS FROM="5" TO="7"

FROM

String. Mandatory.

TO

String. Optional.

RETEN_GEN

(z/OS only) Maximum number of generations to keep in the History Jobs file. String. Optional.

RETEN_GEN FROM="3" TO="4"

FROM

String. Mandatory.

TO

String. Optional.

PREV_DAY

Optional.

PREV_DAY FROM="N" TO="Y"

FROM

Mandatory. Valid values:

• Y
• N

TO

Optional. Valid values:

• Y
• N

IND_CYCLIC

Indicates whether the time interval between runs of a cyclic job is counted from the start or the end of the previous job run. Optional.

IND_CYCLIC FROM="Y" TO="N"

FROM

Mandatory. Valid values:

• START
• END

TO

Optional. Valid values:

• START
• END

RULE_BASED_
CALENDAR_
RELATIONSHIP

Relationship (AND|OR) between the specified Rule-Based Calendar and the job’s own basic scheduling criteria. Optional.

RULE_BASED_CALENDAR_RELATIONSHIP FROM="AND" TO="OR"

FROM

Mandatory. Valid values:

• AND
• OR

TO

Optional. Valid values:

• AND
• OR

TAG_
RELATIONSHIP

Relationship (AND|OR) between the specified Schedule Tag criteria and the job’s own basic scheduling criteria. This parameter is relevant only for jobs in a SMART Folder. Optional. This parameter is for backward compatibility.

TAG_RELATIONSHIP FROM="AND" TO="OR"

FROM

Mandatory. Valid values:

• AND
• OR

TO

Optional. Valid values:

• AND
• OR

SYSDB

Determines whether single or multiple data sets are used to catalogue sysdata. Optional.

SYSDB FROM="1" TO="0"

FROM

Mandatory. Valid values:

• 0 (Multiple. Default)
• 1 (Single)

TO

Optional. Valid values:

• 0 (Multiple. Default)
• 1 (Single)

PDSNAME

Name of partitioned dataset (PDS) to be checked for free space. String. Optional.

PDSNAME FROM="Lib_3" TO="Lib_5"

FROM

String. Mandatory.

TO

String. Optional.

MINIMUM

Minimum number of free partitioned dataset tracks required by the library specified for the PDSNAME parameter. Integer. Optional.

MINIMUM FROM="5" TO="6"

FROM

Integer. Mandatory.

TO

Integer. Optional.

CATEGORY

Name of a Control-D report decollating mission category that must be scheduled under Control-D when the job is scheduled under Control-M. String. Optional.

CATEGORY FROM="*" TO="DAILY"

FROM

String. Mandatory.

TO

String. Optional.

PREVENTNCT2

(z/OS only) Prevents dataset clean up before the original job run Optional. Valid values:

• Blank – Does not perform data set clean up before the original job run. Default.
• N – Does not prevent clean up.
• Y - Prevents data set clean up. This value is not valid for started tasks.
• L (List) – Do not perform data set clean up before the original job run. Do generate messages that would be required for CDG adjustment during restart.
• F (Flush) – Halt processing of the job if any data set clean up error is detected (even if z/OS would not have stopped processing the job).

  PREVENTNC2 FROM="1" TO="0"

FROM

Mandatory. Valid values:

• 0 (Do not prevent)
• 1 (Prevent)

TO

Optional. Valid values:

• 0 (Do not prevent. Default.)
• 1 (Prevent)

JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP,
OCT, NOV, DEC

Months when the job can run. Optional. Not including a month is the same as including that month with the value 0.

JAN FROM="0" TO="1"

JUL FROM="0" TO="1"

FROM

Mandatory. Valid values:

• 0 (Do not run the job. Default)
• 1 (Run the job.)

TO

Optional. Valid values:

• 0 (Do not run the job. Default)
• 1 (Run the job.)

OPTION

Job output (Output) handling options. Optional.

OPTION FROM="Copy" TO="Release"

FROM

Mandatory. Valid values:

• Release
• Delete
• Copy
• Move
• File
• NewDest
• ChangeClass

TO

Optional. Valid values: same as mandatory FROM values.

PAR

Certain OPTION values require that you supply additional information (such as Release, NewDest). The PAR parameter holds that information as a string. Optional.

PAR FROM="mem3log" TO="mem5log"

FROM

String. Mandatory.

TO

String. Optional.

FROM

Limits the OUTPUT handling operation to OUTPUTs from the specified class. Optional.

FROM FROM="1" TO="2"

FROM

String. Mandatory.

TO

String. Optional.

ADJUST_COND

Indicates whether to ignore prerequisite conditions normally set by predecessor jobs if the relevant predecessor jobs are not scheduled. This parameter is relevant only for jobs in a SMART Folder. Optional. Valid values:

• 0 (Do not ignore. Default.)
• 1 (Ignore relevant prerequisite conditions.)

  ADJUST_COND FROM="1" TO="0"

FROM

String. Mandatory.

TO

String. Optional.

APPL_TYPE

Type of external application (for example, SAP or Oracle) on which the external application job runs. Mandatory for external application jobs.

APPL_TYPE FROM="SAP" TO="OracleApps"

FROM

Mandatory. String. Up to 10 characters.

TO

Optional. String.

APPL_VER

Version of the external application (for example, SAP or Oracle) on which the external application job runs. Mandatory for external application jobs.

APPL_VER FROM="4.5" TO="4.6"

FROM

Mandatory. String. Up to 10 characters.

TO

Optional. String.

APPL_FORM

Predefined set of external application parameters that are displayed in the Job Properties team. Mandatory for external application jobs.

APPL_FORM FROM="Default SAP 4.6" TO="Default SAP 4.5"

FROM

Mandatory. String. Up to 30 characters.

TO

Optional. String.

CM_VER

Version of external Application Add-on (for example, SAP or Oracle) that is installed in the Control-M installation. Mandatory for external application jobs.

CM_VER FROM="6.1.00" TO="6.1.01"

FROM

Mandatory. String. Up to 10 characters.

TO

Optional. String.

MULTY_AGENT

When selected, broadcasts job submission details to all agents in a specified Host Group. Optional.

MULTY_AGENT FROM="N" TO="Y"

FROM

Mandatory. Valid values:

• Y – Run as multi-agent job
• N – Do not run as multi-agent job. Default.

TO

Optional. String.

ACTIVE_FROM

(z/OS only) Start of a period of time during which the job or SMART Folder can be ordered. Optional.

ACTIVE_FROM FROM="20070315" TO="20070601"

FROM

Mandatory. Date Format: YYYYMMDD

TO

Optional. String.

ACTIVE_TILL

(z/OS only) End of a period of time during which the job or SMART Folder can be ordered. Optional.

ACTIVE_TILL FROM="20070315" TO="20070601"

FROM

Mandatory. Date Format: YYYYMMDD

TO

Optional. String.

TIMEZONE

Global time zone used to calculate the interval for time-related conditions. Optional.

TIMEZONE FROM="EST" TO="GMT"

FROM

Mandatory. String. Default: GMT

TO

Optional. String.

SYSTEM_AFFINITY

Identity of the system in which the job must be initiated and executed (in JES2). Identity of the processor on which the job must execute (in JES3). Optional. String.

FROM

String. Mandatory.

SYSTEM_AFFINITY FROM="SYS3"

TO

String. Optional.

SYSTEM_AFFINITY FROM="SYS3" TO="SYS6"

REQUEST_NJE_
HOST

Host in the JES network on which the job is to execute.

FROM

String. Mandatory.

REQUEST_NJE_HOST="OS5"

TO

String. Optional.

REQUEST_NJE_HOST FROM="OS5" TO="OS6"

SCHEDULING_
ENVIRONMENT

(z/OS only) Indicates the JES2 workload management scheduling environment associated with the job.

FROM

String. Mandatory.

SCHEDULING_ENVIRONMENT FROM="SCHD2"

TO

String. Optional.

SCHEDULING_ENVIRONMENT FROM="SCHD2" TO="SCHD3"

CREATION_USER

Name of the user that created the job. String. Optional.

CREATION_USER FROM="emuser" TO="em1"

FROM

String. Mandatory.

TO

String. Optional.

CREATION_DATE

Date that the job was created. String. Optional.

CREATION_DATE FROM="1212" TO="2012"

FROM

String. Mandatory.

TO

String. Optional.

CREATION_TIME

Time that the job was created. String. Optional.

CREATION_TIME FROM="1230" TO="1430"

FROM

String. Mandatory.

TO

String. Optional.

CHANGE_USERID

Name of the user that last modified the job. String. Optional.

CHANGE_USERID FROM="emuser" TO="emacct"

FROM

String. Mandatory.

TO

String. Optional.

CHANGE_DATE

Date that the job was last modified. String. Optional.

CHANGE_DATE FROM="1204" TO="1304"

FROM

String. Mandatory.

TO

String. Optional.

CHANGE_TIME

Time that the job was last modified. String. Optional.

CHANGE_TIME FROM="1650" TO="1700"

FROM

String. Mandatory.

TO

String. Optional.