Calendars

Control-M Calendars enable you to define a set of scheduling criteria in a pre-defined calender and then apply it in a job definitionClosedThe set of parameters that defines what the job does, when it must run, its prerequisites to run, and post-processing actions for Control-M to perform after its completion (also called a job processing definition). This process creates the scheduling definition once instead of defining it for each job.

The following lists the type of calendars you can define:

  • Regular Calendar: Creates a schedule based on specific dates, such as, days of the month, and days of the week in a selected year, as described in Creating a Regular Calendar

  • Periodic Calendar: Creates a schedule based on different calendar periods other than months and days, as described in Creating a Periodic Calendar

  • Rule Based Calendar: Creates a schedule based on specific rules, as described in Creating a Rule Based Calendar

The following video describes Control-M calendars:

Creating a Regular Calendar

This procedure describes how to create a Regular calendar that schedules jobs to run on specific month days and week days for a selected year.

Begin

  1. From the Tools drop-down list, select Calendars.

    The Calendars page appears.

  2. Click Add Calendar.

    The Add a Regular calendar pane appears.

  3. From the Calendar Type drop-down list, select Regular.

  4. From the Control-M Server drop-down list, select the Control-M/Server to sync the calendar, or select All.

    All refers to all Control-M/Servers, both distributed and mainframe systems. The calendar name must meet the calendar validation criteria for both systems.

  5. In the Calendar Name field, type the name of the calendar.

    z/OS: Uppercase only and up to 8 characters.

  6. In the Description field, provide a description of the calendar and then click Add.

    An empty Regular calendar appears.

  7. From the top-left drop-down list select a year, and then select the required dates.

    The dates that your select appear in the Calendar Summary in the right pane.

  8. If you have dates that occur every month, select the recurring dates across the calendar, as follows:

    1. From the Calendar toolbar, click Recurrence.

    2. From Apply From and To drop-down list, select a month and year time range.

    3. In Apply On, in Month Days select the specific dates of the month, and in Week Days select the specific days of the week.

    4. Click Apply.

      The dates appear in the calendar.

  9. From the Calendar toolbar click Save, and then click Publish.

    The calendar appears in the Calendars page with a published status and editing enabled.

    To manually synchronize the calendar, click Push Calendar. You can manually synchronize if the Control-M/Server is not configured to sync, or if there are synchronization errors and you want the calendar to be available.

    To download the latest existing copy of the calendar in the Control-M/Server, use the Pull Calendar option.

Periodic Calender

A Periodic calendar is used to schedule jobs to run according to time periods other than months and days. Periodic calendars divide the year into working periods, for example, 4 quarter periods instead of 12 months. Periods can be nonconsecutive and of varying length, but a period cannot exceed 255 days or be broken up by more than 33 days.

You can create a period that is more than one year. For example, Period A can include November 2019 through February 2020. Scheduling a job using a Periodic calendar, enables you to select the periods that the job runs in, and add additional scheduling criteria.

Creating a Periodic Calendar

This procedure describes how to create a Periodic calendar that schedules jobs to run according to time periods other than months and days.

Begin

  1. From the Tools drop-down list, select Calendars.

    The Calendars page appears.

  2. From the calendar toolbar, click Add Calendar.

    The Add a Regular calendar pane appears.

  3. From the Calendar Type drop-down list, select Periodic.

  4. From the Control-M Server drop-down list, select the Control-M/Server to sync the calendar, or select All.

    All refers to all Control-M Servers, both distributed and mainframe systems. The calendar name must meet the calendar validation criteria for both systems.

  5. In the Calendar Name field, type the name of the calendar.

    z/OS: Uppercase only and up to 8 characters.

  6. In the Description field, provide a description of the calendar.

  7. Click Add.

    An empty Periodic calendar appears.

  8. Define your periods, as follows:

    1. From the Period drop-down in the left pane, do one of the following:

      • Select a letter or number from 0-9, such as A.

      • For dates that you want to select in all periods, select Period *.

    2. From the year drop-down list, select the year.

    3. Mark the dates of the calendar that you want in this period.

      The dates that your select for the period appear in the Calendar Summary on the right pane.

  9. For dates that occur every month mark the recurring dates across the calendar, as follows:

    1. From the Calendar toolbar, click Recurrence.

    2. From Apply From and To, select a month and year time range.

    3. In Apply On, select the specific dates of the month, and specific days of the week.

    4. Click Apply.

      The dates appear in the calendar.

  10. From the Calendar toolbar click Save, and then click Publish.

    The calendar appears in the Calendars page with a published status and editing enabled.

    To manually synchronize the calendar, click Push Calendar. You can manually synchronize if the Control-M/Server is not configured to sync, or if there are synchronization errors and you want the calendar to be available.

    To download the latest existing copy of the calendar in the Control-M/Server, click Pull Calendar.

Rule Based Calendar

A Rule-Based Calendar (RBC) is used to define a scheduling criteria that is applied to selected folders, sub-folders, and jobs using specific rules. RBC are used where values cannot be specified as absolute values, such as specific days or specific dates, and requires a more complex scheduling criteria.

The following lists the types of RBCs you can define:

  • Specific Dates: Defines the scheduling criteria based on specific dates, independent of a calendar year, for up to 12 months.

  • Week Days: Defines the scheduling criteria based on specific week days, or on specific week days in specific weeks, which can also be based on a calendar.

  • Month Days: Defines the scheduling criteria based on specific month days, which can also be based on a calendar.

  • Advanced: Defines the scheduling criteria based on a combination of scheduling options including months, week days, and month days.

Creating a Rule Based Calendar

This procedure describes how to create a Rule-Based calendar (RBC), that schedules jobs to run using specific rules.

Begin

  1. From the Tools drop-down list, select Calendars.

    The Calendars page appears.

  2. Click Add Calendar.

    The Add a Regular calendar pane appears.

  3. From the Calendar Type drop-down, select Rule-Based.

  4. From the Control-M Server drop-down list, select the Control-M/Server to sync the calendar, or select All.

    All refers to all Control-M Servers, both distributed and mainframe systems. The calendar name must meet the calendar validation criteria for both systems.

  5. In the Calendar Name field, type the name of the calendar.

    z/OS: Uppercase only and up to 8 characters.

  6. Click Add.

    An empty RBC appears.

  7. To define the RBC based on specific dates, independent of a calendar year, for up to 12 months, do the following:

    1. From the top-left drop-down list, select Specific Dates.

      A yearly calendar appears.

    1. Select the dates that you want the job to run on.

  8. To define a RBC based on week days, month days, or week or month days, do one of the following:
  1. Define Advanced Options, as described in Rule-Based Calendar Advanced Options Parameters.

  1. From the Calendar toolbar click Save, and then click Publish.

    The calendar appears in the Calendars page with a published status and editing enabled.

    To manually synchronize the calendar, click Push Calendar. You can manually synchronize if the Control-M/Serveris not configured to sync, or if there are synchronization errors and you want the calendar to be made available.

    To download the latest existing copy of the calendar in the Control-M/Server, click Pull Calendar.

Scheduling a RBC on Week Days

This procedure describes how schedule a RBC based on specific week days, or on specific week days in specific weeks of the month.

Begin

  1. From the top-left drop-down list, select Week Days.

    The Run on Week Days and Run on Months areas appear.

  2. In the Run on Week Days area, do one of the following:

    • To run the job on a specific week day, in the Run tab, select the week day.

    • To run the job on a specific day in a specific week of the month, in the Start of week tab, select the week days.

      You can select to schedule jobs in more than one week, for example in W1 Monday and Tuesday, and W2 Monday and Thursday.

  3. In the Run on months area, select the months when you want the job to run.

Scheduling a RBC on Month Days

This procedure describes how to schedule a RBC based on month days.

Begin

  1. From the top-left drop-down list, select Month Days.

    The Run on Month Days and Run on Months areas appear.

  2. In the Run on Month Days area, do one of the following:

    • From the Run tab, select the day of the month when you want the job to run.

    • From the End of month tab, do one of the following:

      • To run the job on the same number of working day or days before the end of the month, select the number of days, and then select the On day from end of month option.

        If you select L1, the job runs one day before the end of the month. If the month is 30 days, the job runs on the 29th.

      • To run the job on all days in the month except the same number of working day or days before the end of the month, select the number of days, and then select the On all days except on selected day from end of month option.

        If you select -L1, the job does not run one day before the end of the month. If the month is 30 days, the job runs on all days of the month except the 29th.

  3. In the Run on Months area, select the months when you want the job to run.

Scheduling a RBC on Week or Month Days Based on a Calendar

This procedure describes how to schedule an RBC based on week or month days.

Begin

  1. From the top-left drop-down list, select Week Days or Month Days.

    The Run on Week Days or Run on Months area appear.

  2. In the Run on Week Days or Run on Months area, from the Based on calendar drop-down list, select a calendar.

  3. Do one or more of the following, based on your scheduling requirements:

    From the Run tab, select the day of the week or month.

    If you select a Periodic Calender then select the days where the job should not run. If you select Regular Calendars, then from the Run job dialog box, select one of the following:

    • Run also on non-working days: Runs the jobs on the selected day, even if the job is not a working day in the base calendar.

    • Select working day: Runs the jobs on the selected day, only if the day is a working day in the base calendar.

    • All working days except selected day: Runs the jobs on all other working days except the selected day, even if the day is a working day in the base calendar.

    Select one of the following:

    • Day or on next working day (>): Runs the jobs on the selected day. If that day is not a working day in the base calender, the job is run on the next working day.

    • Day or on previous working day (<): Runs the jobs on the selected day. If that day is not a working day in the base calendar, the job is run on the previous working day.

    From the Start of week tab, select the week of the month and the week day, or on Start of month select the month. From the Run job dialog box, select one of the following:

    • On day if working day (D): Runs the jobs on the selected day, if the day is a working day in the base calendar.

      If you select D1, the job runs on day 1 of every working week or month.

    • All working days except selected day (-D): Runs the jobs on all other working days except the selected day, even if the day is a working day in the base calendar.

      If you select -D1, the job runs on all working days in calendar, except day 1 of every working week or month.

    Week Days:

    • If you select a Regular calendar, you can select days from the start of the week for each week in the month. For example, D3W2 schedules the job in the second week of the month, on the 3rd day of that week.

    • If you select a Periodic calendar, you can select days from the start of the week for each week in the period. For example, D3PA schedules the job on the third day of the week throughout Period A.

    Month Days: You cannot select the week in the month or the period.

    From the End of week or End of month tab, select the day of the week or month. From the Run job dialog box, select as follows:

    • On day from end of week (L): Runs the job on the selected day from the end of the week.

      If you select L1, the job runs one day from the end of the week or month.

    • On all days except on selected day from end of week (-L): Runs the jobs on all other working days except the selected day from the end of the week.

      If you select -L1, the job does not run one day from the end of the week or month.

    Week Days: If you select a Periodic calendar, you can select the days from the end of the week for each week in the period. For example, L3PA schedules the job on the third day of the week throughout the A period.

    Month Days: You cannot select the period.

Rule-Based Calendar Advanced Options Parameters

The following table describes the RBC Advanced Options parameters:

Parameter

Description

Confirmation Calendar

Defines the confirmation calendarClosedA calendar that you use to confirm the days when jobs run, with a policy for non-working days that is used to confirm the scheduling dates of the calendar. Jobs that are scheduled on a specific day are checked against the confirmation calendar.

Calendar

Defines the confirmation calendar, that can be a Regular or Periodic calendar that has already been published.

Exception Policy

Determines one of the following policies for when a job that is scheduled to run is not in the confirmation calendar.

  • Disable run: Prevents the job from running.

  • Run on next confirmed day: Runs the job on the next day that is in the confirmation calendar.

  • Run on previous confirmed day: Runs the job on the previous day that is in the confirmation calendar.

  • Run (Ignore Confirmation Calendar): Runs the job, ignoring the confirmation calendar.

Shift by

Determines the number of working days that Control-M can shift a job. Depending on the shift value, the job is scheduled on an earlier day, a later day, on the original scheduling date, or does not run.

Valid values:

  • 0: Prevents the job from running.

  • 1-99: Shifts the job to run the number of days that you specify, in either direction.

Activity Period

Pauses the job from running for a period of time without the need to change its job definitionClosedThe set of parameters that defines what the job does, when it must run, its prerequisites to run, and post-processing actions for Control-M to perform after its completion (also called a job processing definition) or calendar, as follows:

  • Always: Job is not restricted by an Activity period.

  • Active: Activates the job between the From and To dates that you define.

  • Not Active: Deactivates the job between the From and To dates that you define.

Active Environment Retention

Defines the Keep Active policy.

Keep Active

Determines the number of extra days after the ODATEClosedThe date that a job joins the Run Queue that the job can await execution. At midnight, Control-M delays the following by the number of Keep Active days:

  • Jobs that are in a waiting status are set to Ended OK.

  • The removal of a folder where all jobs are waiting.

Valid values:

  • For: Keeps the job active and awaiting execution for the number of extra days that you define, as follows:

    • 0: Executes only on the ODATE.

    • 1-98: Awaits execution for the number of extra days that you define.

    • 99: Remains active with no limit.

  • Forever: Keeps the folder active with no limit.

Copying a Calendar Year

This procedure describes how to copy selected dates from one year to another year in your schedule.

Begin

  1. From icon on the calendar ribbon, select Copy Year.

  2. From the Copy From drop-down list, select the year with the dates you want to copy.

  3. From the Copy To drop-down list, select the years where you want to copy the dates.

    If you want to clear the dates from a year, select the icon on the calendar ribbon, and select Clear Year.