Scheduling

Scheduling attributes determine the date and time when your SMART folder, sub-folder, and jobs are execute.

You can define scheduling attributes for a SMART folder, sub-folder, and job as follows:

  • SMART Folder: Enables you to schedule a SMART folder using a predefined Rule-Based Calendar or create an ad hoc Rule-Based Calendar.

  • Sub-folder: Enables you to schedule a sub-folder using a specific Rule-Based Calendar from one or all parent SMART folders.

  • Job: Enables you to schedule jobs every day, specific days, weekdays, month days, or the days scheduled in the parent SMART folder.

SMART Folder Scheduling Attributes

The following table describes the attributes that you must complete when scheduling a SMART folder.

Attribute

Description

View Schedule

Enables you to view all the calendar dates in a selected year of the selected rule-based calendar.

Use

Determines which rule-based calendars are used that define when the SMART folder runs.

You can select a predefined rule-based calendar on the Control-M/Server or create a new one for this SMART folder, as described in Creating a SMART Folder Rule-Based Calendar.

Exclude

Determines which rule-based calendars are used that define when the SMART folder does not run.

You can select a predefined rule-based calendar on the Control-M/Server or create a new one for this SMART folder, as described in Creating a SMART Folder Rule-Based Calendar.

Details

Enables you to do the following:

  • View and edit the details of a SMART folder rule-based calendar.

  • View the details of a Control-M/Server rule-based calendar.

Time Settings

Determines the time frame when the SMART folder must execute.

From

Determines the earliest time that the SMART folder executes, as follows:

To

Determines the latest time that the SMART folder executes, as follows:

  • End of Day (New Day Time): The SMART folder waits until the end of the day for the prerequisitesClosedThe part of the job definition that controls the flow of your jobs, such as an event that controls sequence or a resource that controls load to be met.

  • Allow Submission Past Next New Day (>): The SMART folder waits indefinitely for the prerequisites to be met.

    If the SMART folder remains in the Monitoring domain the following day, it executes as soon as the prerequisites are met. It does not wait until the defined From time to execute.

  • Select Time: The SMART folder waits until the time that you define for the prerequisites to be met.

    If the SMART folder remains in the Monitoring domain the following day, it waits to execute only until the defined time and when the prerequisites are met.

Must End

(z/OS Only) Defines the date and time when the SMART folder must finish executing. This includes the days offset.

Cyclic

Determines whether to schedule a folder as cyclicClosedA folder or job that executes multiple times in one run, at a specific interval or specific times, or according to a specific sequence of intervals.

Rerun

Determines the time interval between SMART folder executions, as follows:

  • Interval: Defines a regular interval between SMART folder executions, in minutes, hours, or days, measured from the Start, End, or Target of the last execution of a SMART folder.

  • Using Interval Sequence: Defines a sequence of varying intervals between SMART folder executions, in minutes, hours, or days, measured from the Start or End of the last execution of a SMART folder.

  • At Specific Times: Determines a specific time of day for SMART folder execution, in hours and minutes, AM or PM.

Tolerance

Determines the number of minutes to supplement the rerun execution time if the current SMART folder execution overruns the time defined in At Specific Times.

If the time of day defined in At Specific Times plus the Tolerance time is overrun, the SMART folder waits for the next time defined in At Specific Times to execute, once the prerequisites are met.

On z/OS, you can add the days offset.

Maximum Reruns

Determines the maximum number of reruns, as follows:

Rules:

  • 0–99

  • z/OS:
    • Cyclic Jobs: 0–9,999

    • Regular Jobs: 0–255

For more information, see Events.

Time Zone

Determines the time zone where the SMART folder is scheduled to run. For more information, see Time Zone.

Your Agent is located in Sydney, but you want the SMART folder to run at 09:00 in Hawaii, so you select HNL (GMT-10:00) from the drop-down list.

Rerun Member

(z/OS Only) Defines the name of the JCL member to use when the job automatically reruns.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

Statistics Calendar

(z/OS Only) Defines the name of the Control-M periodic calendar where the job statistics are collected.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

Keep Active

Determines the number of additional days after the defined run date that the SMART folder remains active and awaits execution,

if it fails to execute at the originally defined time. Sub-folders and jobs in a SMART folder remain active according to the Keep Active value defined in the SMART folder.

  • The job status for waiting jobs changes to Ended OK on the following day.

  • All jobs are kept in the SMART folder until it is removed.

Valid Values:

  • For: Keeps the SMART folder active, where it awaits execution for the number of extra days that you define, as follows:

    • 0: SMART folder executes only on the run date.

    • 1–98: SMART folder awaits execution for the number of extra days that you define.

  • Forever: Keeps the SMART folder active, where it awaits execution indefinitely.

Keep Jobs in Folder

Determines whether to keep the jobs in the SMART folder until all of the jobs complete execution. They are then removed at the same predefined date as the SMART folder.

Keep Folder For

Enables you to specify a minimum period to keep the SMART folder in the Active Jobs database after the SMART folder is set to Not OK. This option is only available when you select the Keep All Jobs in Folder checkbox.

SAC

(z/OS Only) Determines whether to adjust the logical date for a SMART folder that is converted from a scheduling product other than Control-M.

Creating a SMART Folder Rule-Based Calendar

This procedure describes how to create an rule-cased calendar in a SMART folder for use by the sub-folders and jobs in the SMART folder. This rule-cased calendar cannot be used in other SMART folders.

Begin

  1. In the Use or Exclude fields, click and select + Folder Rule-Based Calendar.

    The New Folder Rule-Based Calendar pane appears.

  2. Define the scheduling attributes as described in SMART Folder Rule-Based Calendar Attributes.

  3. Click OK.

    The SMART-folder-specific rule-based calendar appears in the Use or Exclude tables.

  4. To view and edit the SMART-folder-specific rule-based calendar, click .

SMART Folder Rule-Based Calendar Attributes

The following table describes the attributes that you must complete when Creating a SMART Folder Rule-Based Calendar.

Attribute

Description

Name

Defines the name of the SMART folder rule-based calendar.

Rules:

  • Characters: 1–30

  • Invalid Characters: * (asterisks), blank spaces.

Schedule

Defines the scheduling of the SMART folder rule-based calendar as follows:

  • Every Day: Runs the jobs in the SMART folder every day.

  • None: Does not schedule the jobs, and only runs them manually, as described in Running Jobs or a Workspace.

  • Specific Dates: Runs the jobs in the SMART folder on dates that you select.

  • Free Space on PDS: (z/OS Only) Defines the name of a partitioned data set (PDS) that is checked for free space, as follows:

    • Partition Data Set: Defines the name of a partitioned data set to check for free space. If the partitioned data set has fewer than the minimum number of required free tracks (as defined in the Minimum Number of Tracks Parameter), the job is executed.
    • Minimum Number of Tracks: Defines the minimum number of free partitioned data set tracks required by the library that is specified for the Partition Data Set parameter.
  • Advanced: Runs the jobs in the SMART folder according to weekdays and/or month days, and specific months using a rule-based calendar.

Calendar

Defines the confirmation calendarClosedA calendar that you use to confirm the days when jobs run, with a policy for non-working days that validates your scheduling dates, which can be any Regular or Periodic Calendars that are already published. Jobs in SMART folders that are scheduled on a specific day are checked against the confirmation calendar.

Exception Policy

Determines one of the following policies to apply 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 and ignores the confirmation calendar.

Shift By

Determines the number of working days that Control-M can shift a job run. Depending on the shift value and the Exception Policy, the job runs on an earlier day, a later day, the original scheduling date, or never.

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

Defines the period that the jobs in the SMART folder are active, which enables you to restrict their run dates without the need to change the scheduling definition or calendarClosedA reusable job schedule that you can apply to many jobs, which enables you to perform schedule changes from a single location, as follows:

  • Always: Does not restrict the jobs in the folder by an Activity Period.

  • Active: Activates the jobs in the folder between the From and To dates that you specify.

  • Not Active: Deactivates the jobs in the folder between the From and To dates that you specify.

Sub-folder Scheduling Attributes

The following table describes the attributes that you must complete when scheduling a sub-folder.

Attribute

Description

View Schedule

Enables you to view all the calendar dates in a selected year of the selected rule-based calendar.

Use

Determines which parent rule-based calendars are used that define when the sub-folder runs, as follows:

  • All Parent Calendars: The sub-folder runs on the dates defined in all the parent SMART folder rule-based calendars.

  • Select from Parent: The sub-folder runs on the dates defined in the parent SMART folder rule-based calendars that you select.

Exclude

Determines which Control-M/Server rule-based calendars are used that define when the sub-folder does not run.

Details

Enables you to view the details of a rule-based calendar.

From

Determines the earliest time that the sub-folder can execute, as follows:

To

Determines the latest time that the sub-folder executes, as follows:

  • End of Day (New Day Time): The sub-folder waits until the end of the day for the prerequisitesClosedThe part of the job definition that controls the flow of your jobs, such as an event that controls sequence or a resource that controls load to be met.

  • Allow Submission Past Next New Day: The sub-folder waits indefinitely for the prerequisites to be met.

    If the sub-folder folder remains in the Monitoring domain the following day, it executes as soon as the prerequisites are met. It does not wait until the defined From time to execute.

  • Select Time: The sub-folder waits until the time that you define for the prerequisites to be met.

    If the sub-folder remains in the Monitoring domain the following day, it waits to execute only until the defined time and when the prerequisites are met.

Time Zone

Determines the time zone where the sub-folder is scheduled to run. For more information, see Time Zone.

Your Agent is located in Sydney, but you want the sub-folder to run at 09:00 in Hawaii, so you select HNL (GMT-10:00) from the drop-down list.

Must End

(z/OS Only) Defines the date and time when the sub-folder must finish executing. This includes the days offset.

Rerun Member

(z/OS Only) Defines the name of the JCL member to use when the sub-folder automatically reruns.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

Statistics Calendar

(z/OS Only) Defines the name of the Control-M periodic calendar where the job statistics are collected.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

Keep Active

Determines the number of additional days after the defined run date that the sub-folder remains active and awaits execution,

if it fails to execute at the originally defined time. Jobs in a sub-folder remain active according to the Keep Active value defined in the sub-folder.

  • T job status changes to Ended OK on the following day.

  • All jobs are kept in the sub-folder until it is removed.

Valid Values:

  • For: Keeps the sub-folder active, where it awaits execution for the number of extra days that you define, as follows:

    • 0: The sub-folder executes only on the run date.

    • 1–98: The sub-folder awaits execution for the number of extra days that you define.

  • Forever: Keeps the sub-folder active, where it awaits execution indefinitely.

SAC

(z/OS Only) Determines whether to adjust the logical date for the sub-folder that is converted from a scheduling product other than Control-M.

Job Scheduling Attributes

The following table describes the attributes that you must complete when scheduling a job.

Attributes

Description

Scheduling

Determines the scheduling of the job, as follows:

  • Every Day: Runs the job every day.

  • None: Does not schedule the job and only runs it manually, as described in Running Jobs or a Workspace.

  • Specific Dates: Runs the job on the dates you select.

  • Free Space on PDS: (z/OS Only) Defines the name of a partitioned data set (PDS) to be checked for free space, as follows:

    • Partition Data Set: Defines the name of a partitioned data set to check for free space. If the Partition Data Set has fewer than the minimum number of required free tracks (as defined in the Minimum Number of Tracks Parameter), the job is executed.
    • Minimum Number of Tracks: Defines the minimum number of free partitioned data set tracks required by the library that is specified for the Partition Data Set parameter.
  • Use Parent Schedule: Runs the job according to the scheduling criteria of the parent folder.

  • Advanced: Runs the job on an advanced schedule, as follows:

    • Run on Week Days: Defines a weekday schedule.

    • Run on Month Days: Defines a schedule for the days of the month.

    • Use: Determines which parent rule-based calendars are used that define when the job runs.

    • Exclude: Determines which Control-M/Server rule-based calendars are used that define when the job does not run.

View Schedule

Enables you to view the dates when the folder, sub-folder, or job is scheduled to run.

Time Settings

Determines the time frame when the job must start running.

From

Determines the earliest time that the job can execute, as follows:

To

Determines the latest time that the job can execute as follows:

  • End of Day (New Day Time): Executes the job as soon as the prerequisites are met, until the end of the day.

  • Allow Submission Past Next New Day: Executes the job as soon as the prerequisites are met, until the end of the day.

    If the job remains in the Monitoring domain the next day, the job executes as soon as the prerequisites are met and does not wait for the defined From time.

  • Select Time: Executes the job until the time that you define and when the prerequisites are met.

    If the job remains in the Monitoring domain the next day, the job executes until the defined time and when the prerequisites are met.

Must End

(z/OS Only) Defines the date and time when the job must finish executing. This includes the days offset.

Cyclic

Determines whether to schedule a job as cyclic.

Rerun

Determines the time interval between job executions, as follows:

  • Interval: Defines a regular interval between job executions, in minutes, hours, or days, measured from the Start, End, or Target of the last execution of a job.

  • Using Interval Sequence: Defines a sequence of varying intervals between job executions, set in minutes, hours, or days, measured from the Start or End of the last execution of a job.

  • At Specific Times: Determines a specific time of day for job execution, in hours and minutes, AM or PM.

In z/OS jobs, this area also defines Rerun Member.

For options and rules, see Events.

Tolerance

Determines the number of minutes to supplement the rerun execution time if the current job execution overruns the time defined in At Specific Times.

If the time of day defined in the At Specific Times option plus the Tolerance time is overrun, the job waits for the next At Specific Times to run when the prerequisites are met.

On z/OS, you can add the days offset.

Maximum Reruns

Determines the maximum number of reruns as follows:

Rules:

  • 0–99

  • z/OS:
    • Cyclic Jobs: 0–9,999

    • Regular Jobs: 0–255

Rerun Member

(z/OS Jobs) Defines the name of the JCL member to use when the job automatically reruns.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

Time Zone

Determines the time zone where the job is scheduled to run. For more information, see Time Zone.

Your Agent is located in Sydney, but you want the job to run at 09:00 in Hawaii, so you select HNL (GMT-10:00) from the drop-down list.

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 calendarClosedA reusable job schedule that you can apply to many jobs, which enables you to perform schedule changes from a single location, as follows:

  • Always: Does not restrict the job 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.

Statistics Calendar

(z/OS Only) Defines the name of the Control-M periodic calendar where the job statistics are collected.

Rules:

  • Characters: 1–8

  • Case Sensitive: Yes

  • Invalid Characters: Blank spaces, non-English characters.

SAC

(z/OS only) Determines whether to adjust the logical date for the job that is converted from a scheduling product other than Control‑M.

Keep Active

Determines the number of additional days after the run date that a job can remain active, awaiting execution. Jobs remain active according to the value defined at job level.

For waiting jobs, the status changes to Ended OK on the next day.

Valid Values:

  • For: Keeps the job active, where it awaits execution for the number of extra days that you define, as follows:

    • 0: Job executes only on the run date.

    • 1–98: Job awaits execution for the number of extra days that you define.

  • Forever: Keeps the job active, where it awaits execution indefinitely.

Retroactive Run

Determines whether the job runs when the Control-M/Server comes back up, after it has been down for more than a day and the run was missed, as follows:

  • On: Runs the job, even though the run was missed when the Control-M/Server was down.

  • Off: Does not run the job, since the run was missed when the Control-M/Server was down.

Scheduling a Job Using a Rule-Based Calendar

This procedure describes how to schedule jobs using a Rule-Based Calendar with specific rules.

Before You Begin

Ensure that the Rule-Based Calendar has been created, as described in Calendars.

Begin

  1. From Scheduling - Advanced, in the Rule-Based Calendar area, from the Use drop-down list, select one of the following:

    • All Parent Calendars: Runs the job on the dates as defined in all the calendars of the parent folder.

    • Select from Parent: Runs the job on the dates in a specific calendar as defined in the parent folder as follows:

      • EVERYDAY: If this Rule-Based Calendar is selected, your job runs everyday (set by default).

      • If multiple Rule-Based Calenders are selected, Control-M checks the Rule-Based Calendars sequentially to determine if criteria is met, and applies to the job the first Rule-Based Calendar, whose criteria are met. Subsequent Rule-Based Calenders specified for the job are not checked.

  2. In the Exclude field, click , and select the Rule-Based Calendar to exclude. The Rule-Based Calendar selected determines the dates when the job does not run.

    If selecting Rule-Based Calenders to include and exclude, Control-M checks those to include first, and then those to exclude.

    If you select to use the EVERYDAY Rule-Based Calendar, and select a further calender that excludes weekends, and holidays, your jobs will run every day that is not a weekend or holiday.

Scheduling a Job on Week Days

The following procedure describes how to schedule jobs on specific week days, or on specific week days in specific weeks of the month.

Begin

  • From Scheduling - Advanced, in the 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 and week day.

      You can schedule to run a job in more than one week at a time, for example, you can run it on a Monday in W1, and on a Tuesday and Thursday in W2.

Scheduling a Job on Month Days

The following procedure describes how to schedule jobs on month days.

Begin

  • From Scheduling - Advanced, in the 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, then the job runs one day before the end of the month. If the month has 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, then the job does not run one day before the end of the month. If a month has 30 days, the job runs on all days of the month except the 29th.

Scheduling a Job in Specific Months

The following procedure describes how to schedule jobs in specific months.

Begin

  • From Scheduling - Advanced, in the Run on months area, select the months when you want the job to run.

    If you want a job to run in January and September, click Clear All, and select January and September.

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

This procedure describes how to schedule a job on week or month days based on a calendarClosedA reusable job schedule that you can apply to many jobs, which enables you to perform schedule changes from a single location.

  • You can schedule a job to run on all working Mondays in July and August.

  • You can schedule a job to run on the 1st and 15th day of the month even when they do not appear in the calendar, while ensuring that the job is not scheduled on the 10th and 25th day of the month even when they do appear in the calendar.

Begin

  1. From Scheduling - Advanced, in the Week Days or Month Days area, from the Calendar drop-down list, select a calendar.

  2. 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.

Confirmation Calendar Parameters

The following table describes the Confirmation Calendar parameters:

Parameters

Description

Calendar

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

Exceptional Policy

Determines one of the following policies to apply 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 and ignores the confirmation calendar.

Shift by

Determines the number of working days that Control-M can shift a job run. Depending on the shift value and the Exception Policy, the job runs on an earlier day, a later day, the original scheduling date, or never.

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.