Scheduling
Scheduling attributes determine the date and time when your SMART folder, sub-folder, and jobs execute.
You can define scheduling attributes for SMART folders, sub-folders, and jobs as follows:
-
SMART Folder: Enables you to schedule a SMART folder to run and execute according to a predefined or new Rule-Based calendar.
-
Sub-folder: Enables you to schedule a sub-folder to run and execute according to a predefined Rule-Based calendar used by one or all parent SMART folders.
-
Job: Enables you to schedule jobs to run and execute according to a new or predefined Rule-Based calendar used by 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 the calendar dates in a selected year of the Rule-Based calendar that you select. |
Use |
Determines which rule-based calendars are used, which 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:
|
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:
|
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 cyclic A SMART folder or job that executes multiple times in one run, whether for specific intervals, sequences of intervals, or times.. The Complete By and Complete In attributes in SLA Management jobs are not recalculated for successive reruns. For more information, see SLA Management Job. |
Rerun |
Determines the time interval between SMART folder executions, as follows:
|
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 job reruns, as follows:
For more information, see Events. |
Time Zone |
Determines the time zone where the SMART folder is scheduled to execute. For more information, see Time Zones. The Agent is located in Sydney, Australia, but you want the SMART folder to execute at 09:00 in Hawaii, USA, so you search for (GMT-10:00) Pacific/Honolulu in the search field. |
Rerun Member |
(z/OS) Defines the name of the JCL member to use when the job automatically reruns. Rules:
|
Statistics Calendar |
(z/OS only) Defines the name of the Control-M Periodic calendar where the job statistics are collected. Rules:
|
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.
Valid Values:
|
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
-
In the Use or Exclude fields, click and select + Folder Rule-Based Calendar.
The New Folder Rule-Based Calendar pane appears.
-
Define the scheduling attributes as described in SMART Folder Rule-Based Calendar Attributes.
-
Click OK.
The SMART-folder-specific Rule-Based calendar appears in the Use or Exclude tables.
-
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:
|
Schedule |
Defines the scheduling of the SMART folder Rule-Based calendar as follows:
|
Calendar |
Defines the confirmation calendar A calendar that enables you to validate the days when jobs run, and that has a policy for non-working days., as described in Confirmation Calendar. If the SMART folder is scheduled to run on one of the days defined in the confirmation calendar, the Exception Policy, Shift By, and Activity Period definitions are applied. |
Exception Policy |
Determines one of following scheduling changes to apply when a job is scheduled to run on a non-working day in the confirmation calendar.
|
Shift By |
Determines the number of days to shift all scheduled job runs. Valid Values:
|
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 calendar A reusable job schedule that you can apply to many jobs, which enables you to perform scheduling changes from a single location., as follows:
|
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 the calendar dates in a selected year of the Rule-Based calendar that you select. |
Use |
Determines which parent rule-based calendars are used, which define when the sub-folder runs, as follows:
|
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:
|
Time Zone |
Determines the time zone where the sub-folder is scheduled to execute. For more information, see Time Zones. The Agent is located in Sydney, Australia, but you want the sub-folder to execute at 09:00 in Hawaii, USA, so you search for (GMT-10:00) Pacific/Honolulu in the search field. |
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:
|
Statistics Calendar |
(z/OS only) Defines the name of the Control-M Periodic calendar where the job statistics are collected. Rules:
|
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.
Valid Values:
|
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 |
Defines when the job runs, as follows:
|
View Schedule |
Enables you to view the calendar dates in a selected year for the run dates defined in Scheduling. |
Time Settings |
Determines the time frame when the job must start running. |
From |
Determines the earliest time that the job executes, as follows:
|
To |
Determines the latest time that the job executes, as follows:
|
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 A SMART folder or job that executes multiple times in one run, whether for specific intervals, sequences of intervals, or times.. The Complete By and Complete In attributes in SLA Management jobs are not recalculated for successive reruns. For more information, see SLA Management Job. |
Rerun |
Determines the time interval between job executions, as follows:
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 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:
|
Rerun Member |
(z/OS Jobs) Defines the name of the JCL member to use when the job automatically reruns. Rules:
|
Time Zone |
Determines the time zone where the job is scheduled to execute. For more information, see Time Zones. The Agent is located in Sydney, Australia, but you want the job to execute at 09:00 in Hawaii, USA, so you search for (GMT-10:00) Pacific/Honolulu in the search field. |
Activity Period |
Defines the period that the job is active, which enables you to restrict its run dates without the need to change its scheduling definition or calendar A reusable job schedule that you can apply to many jobs, which enables you to perform scheduling changes from a single location., as follows:
|
Statistics Calendar |
(z/OS only) Defines the name of the Control-M Periodic calendar where the job statistics are collected. Rules:
|
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 defined run date that a job remains active and awaits execution, if it fails to execute at the originally defined time. Jobs remain active according to the Keep Active value defined in the job. For waiting jobs, the status changes to Ended OK on the following day. Valid Values:
|
Retroactive Run |
Determines whether the job runs when the Server comes back online after it has been down for more than a day and the run was missed, as follows:
|
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
-
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 calendars 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.
-
-
-
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 the EVERYDAY Rule-Based calendar, and select a further calendar that excludes weekends, and holidays, your jobs will run every day that is not a weekend or holiday.
Scheduling a Job on Weekdays
The following procedure describes how to schedule jobs on specific weekdays, 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 calendar A reusable job schedule that you can apply to many jobs, which enables you to perform scheduling 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
-
From Scheduling - Advanced, in the Week Days or Month Days area, from the Calendar drop-down list, select a calendar.
-
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
A confirmation calendar is a timetable and a user-defined collection of policies that Control-M applies whenever the working days The dates selected in a Regular, Periodic, or Rule-Based calendar. in an RBC do not match the working days in a selected Regular or Periodic calendar. This enables you to automate scheduled jobs and SMART folders to account for holidays and other scheduling exceptions.
The following table describes the confirmation calendar parameters.
Parameters |
Description |
---|---|
Calendar |
Determines a predefined Regular or Periodic calendar that Control-M compares with the RBC. This is also known as the confirmation calendar. |
Exception Policy |
Determines one of following scheduling changes to apply when a job is scheduled to run on a non-working day in the confirmation calendar.
|
Shift By |
Determines the number of days to shift all scheduled job runs. Valid Values:
|
The Rules-Based calendar Production Schedule defines Mo, Tu, We, Th, and Fr as working days. The Holidays confirmation calendar is a user-defined, Regular calendar that defines national holidays as non-working days. The following parameters defined in the Advanced Options > Confirmation Calendar area in the Production Schedule scheduling definitions:
-
Calendar: Holidays
-
Exception Policy: Run on Next Confirmed Day
-
Shift By: 1
During the New Day procedure, Control-M verifies that the job or SMART folder is scheduled to run on a date defined as a working day in Production Schedule and Holidays. If the date is not a working day, the job is pushed to the next working day, and then shifted by an additional working day.