Calendars

Description

(Optional) A textual description for the calendar

Server

Name of Control-M/Server, or Global (for ALL servers, the default)

Alias

Calendar name for z/OS jobs

When

Scheduling definitions for when to run jobs.

Definitions are grouped by year under the Years object. Each year has the following parameters:

• Year — 4-digit calendar year (YYYY format)
• months and dates — A separate parameter for each month in which you want to define dates. All these parameters are optional.
  The parameter name is the first 3 letters of the name of the month.
  The parameter value is a combination of individual days and/or ranges of days.

Description

(Optional) A textual description for the calendar

Server

Name of Control-M/Server, or Global (for ALL servers, the default)

Alias

Calendar name for z/OS jobs

When

Scheduling definitions for when to run jobs.

Definitions are grouped by period under the Periods object.

Each period is identified by its Period parameter, a one-letter period ID. Valid values are from A to Z, excluding N and Y.
For scheduling definitions that are applied to ALL periods, you can define an additional period with a Period parameter value of All.

Further definitions of a period are grouped by year under the Years object. Each year has the following parameters:

• Year — 4-digit calendar year (YYYY format)
• months and dates — A separate parameter for each month in which you want to define dates. All these parameters are optional.
  The parameter name is the first 3 letters of the name of the month.
  The parameter value is a combination of individual days and/or ranges of days.

Note that scheduled dates must not overlap between periods.

Description

(Optional) A textual description for the calendar

Server

Name of Control-M/Server, or Global (for ALL servers, the default)

Alias

Calendar name for z/OS jobs

When

Scheduling parameters that set the rules for when to run jobs. See next table.

Schedule

One of the following options:

• "Everyday" - scheduling is applied every day, provided that the running criteria are met
• "Never" - no scheduling is defined, and the job must be ordered manually

MonthDays

One or more days in the range of 1 to 31

For all days of the month, use "ALL" (the default value).

If you combine the MonthDays property with the MonthDaysCalendar property, you can create advanced rules, using the following syntax:

• 1 — Day 1 included only if defined in the calendar
• +2 — Day 2 included regardless of calendar
• -3 — Day 3 excluded regardless of calendar
• >4 — Day 4 or next closest calendar working day
• <5 — Day 5 or previous closest calendar working day
• D6 or -D6 — The 6th calendar working day since the beginning of the month, to be included or excluded (respectively)
• L7 or -L7 — The 7th from the last calendar working day of the month, to be included or excluded (respectively)
• D6PA or D6P* — If MonthDaysCalendar is of type periodical, you can use PA or P* to specify a calendar period name such as A,B,C, or you can use * for any period.
  This can be added to both D and L, and to both an include or an exclude.

MonthDaysCalendar

The name of a previously defined calendar from which to derive the days of the month

Months

One or more of the following:

"JAN", "FEB", "MAR", "APR","MAY","JUN", "JUL", "AUG",

"SEP", "OCT", "NOV", "DEC"

For all months of the year, use "ALL" (the default value).

WeekDays

One or more of the following:

"SUN","MON","TUE","WED","THU","FRI","SAT"

For all days of the week, use "ALL" (the default value).

In addition, you can specify a specific day in a specific week of the month using a value with the following format: DdayWn
For example, DMONW2 means Monday of the 2nd week of the month. Valid values for n are 1-6.

If you combine the WeekDays property with the WeekDaysCalendar property, you can create advanced rules, using the following syntax:

• SUN — Sunday included only if defined in the calendar
• +MON — Monday included regardless of calendar
• -TUE — Tuesday excluded regardless of calendar
• >WED — Wednesday or next closest calendar working day
• <THU — Thursday or previous closest calendar working day
• D6 or -D6 — The 6th calendar working day of the week (with a number in the range of 0-6), to be included or excluded (respectively)
• L3 or -L3 — The 3rd from the last calendar working day of the week (with a number in the range of 0-6), to be included or excluded (respectively)
• D6PA or D6P* — If WeekDaysCalendar is of type periodical, you can use PA or P* to specify a calendar period name such as A,B,C, or you can use * for any period.
  This can be added to both D and L, and to both an include or an exclude.

WeekDaysCalendar

The name of a previously defined calendar from which to derive the days of the week

DaysRelation

The logical relationship between MonthDays and WeekDays:

• AND — For jobs to run, both WeekDays and MonthDays contraints must be met. The default.
• OR — Jobs will run when either WeekDays constraints are met or MonthDays constraints are met.

SpecificDates

Specific dates for running jobs.

For each date, use the format "MM/DD" (enclosed in quotes). Separate multiple dates with commas.

Note: The SpecificDates option cannot be used in combination with options WeekDays, Months, or MonthDays.
However, since the default for these options is "ALL", you must specify these options with a value of "NONE".

StartDate

Start date, in YYYYMMDD format, for a period when the job can/cannot run. Used with EndDate.

EndDate

End date, in YYYYMMDD format, for a period when the job can/cannot run. Used with StartDate.

ActivePeriod

Whether the defined period (as defined by StartDate and EndDate) is a period of activity or inactivity, with the following values:

• true — Period of activity, when the job CAN run. The default.
• false — Period of inactivity, when the job CANNOT run.

DaysKeepActive

The number of days to keep jobs that did not run at the scheduled date.

Valid values are 0-99. A value of 0 means jobs are not kept at all, and a value of 99 means Forever.

ConfirmationCalendars

Details of a Confirmation calendar to use for validation of scheduling dates, including an indication of how to handle jobs that are scheduled for a non-working day in this calendar.

     Calendar

The name of the predefined Confirmation calendar, in which work days are indicated

     ExceptionPolicy

A policy to follow when a job is scheduled on a non-working day. Choose from one of the following options:

• DoNotOrder (default)
• OrderOnNextConfirmedDay
• OrderOnPreviousConfirmedDay
• OrderAnyway

      ShiftBy

The number of additional confirmed days to move the job, beyond the action specified by the exception policy. Specify one of the following:

• A positive number of additional days to move forward when the exception policy is OrderOnNextConfirmedDay
• A negative number of additional days to move backward when the exception policy is OrderOnPreviousConfirmedDay

The default value is 0.