AX2552

Define scheduling rules for a job

After you create a job, you can run it on demand, or you can schedule it for a future run. Jobs can be scheduled to be run one time, or on a recurring basis. To schedule a job, define scheduling rules for the job.

You can add, edit, and remove the scheduling rules for a job at any time using the Scheduling Rules section of the job properties. You can also flag a rule as active or inactive. If a job has no scheduling rules, or if all of its scheduling rules are inactive, it does not run unless it is run manually.

If you save a job with an active scheduling rule, Axiom Budget Planning and Performance Reporting determines the next scheduled instance of the job and places it in the scheduled jobs list. After that instance has been processed, the next scheduled instance is determined and scheduled, and so on. Each time the job is run using an active scheduling rule, it is run as the current job owner (unless the job is a system job, in which case it is run as the Scheduler Service System identity).

If a job has multiple active scheduling rules, Axiom Budget Planning and Performance Reporting evaluates all of the rules and schedules a single instance of the job for the earliest time allowed by the rules. Multiple scheduling rules do not result in multiple scheduled instances of the job.

NOTE: If a time zone is listed on the Scheduling Rules section of the job, the defined rules are evaluated in the context of that listed time zone. Otherwise, scheduling rules are evaluated in the context of the local time zone for the Scheduler Server. If necessary, you can use the system configuration setting SchedulingBehaviorTimezone to specify a particular time zone for evaluating scheduling rules. For more information about editing system configuration settings, see System configuration settings.

Add a scheduling rule

Add a scheduling rule to a job to schedule it for a future run, either one time or on a recurring basis.

If you only plan to run the job manually on demand, you do not need to create a scheduling rule.

1. In the Scheduler dialog, open a job to edit or create a new job.

2. In the left side of the job, select Scheduling Rules.

   By default, this area is empty. You must add a rule to define scheduling for the job.

3. On the Job tab of the Scheduler ribbon, in the Scheduling Rules section, click Add.

   A new row appears in the right side of the job. By default, the new row is active but does not have start/end dates or any specific recurrence settings.

4. Complete the following settings within the row, as needed:

   Item	Description
   Active	If you want the job to be placed on the schedule as soon as you save the job with the new scheduling rule, leave this option checked. However, if you just want to save your schedule settings but are not ready to begin scheduling the job, you can clear the Active check box for the rule. The job is not scheduled until it is saved with an active scheduling rule.
   Starting On Ending On	Optional. These dates specify the time frame for the scheduling rule. The starting date defines the earliest point in time you can schedule the job, and the ending date defines the latest point in time you can schedule that the job. If these dates are not defined (left blank), the job is perpetually scheduled according to the rule settings, as long as the rule is active. If you want to schedule a one-time job, set the starting/ending dates to the same date and time. NOTE: Your system locale determines the format of dates.
   Day of Week	Specify the day(s) of the week that you want the job to be run: * (Default): The job will run on all days within the start/end range. 0-6: The job will run on the specified day or days, where 0 is Sunday and 6 is Saturday. Use a comma or a hyphen to separate multiple days (hyphen if the days are contiguous; commas if not). For example, you can enter 1,3,5 for Monday, Wednesday, and Friday, or enter 1-5 for Monday through Friday.
   Hours	Specify the time of day (hours) that you want the job to run in relation to the specified days: * (Default): The job will run on all hours. 0-23: The job will run on the specified hour or hours, where 0 is midnight and 23 is 11:00 PM. Use a comma or a hyphen to separate multiple hours (hyphen if the hours are contiguous; commas if not). For example, you can enter 0,12 to run at midnight and noon, or enter 0-12 to run every hour from midnight to noon.
   Minutes	Specify the time of day (minutes) that you want the job to run in relation to the specified hours: * (Default): The job will run on all minutes (essentially the job is run continuously, once per minute). 0-59: The job will run on the specified minute or minutes of the hour, where 0 is the first minute of the hour and 59 is the last minute of the hour. Use a comma or a hyphen to separate multiple minutes (hyphen if the hours are contiguous; commas if not). For example, you can enter 0,30 to run at the top of the hour and the half hour, or enter 0-30 to run every minute from the top of the hour to the half hour. NOTE: If you specify an hour, in most cases, you should also specify a minute (such as 0 to run the job at the top of the specified hour). If you enter an hour but leave the minutes at the default asterisk, the job runs every minute in that hour.

If you select the Active check box for the rule when the job is saved, Axiom Budget Planning and Performance Reporting calculates the date and time of the first scheduled run and places the job on the schedule.

Edit a scheduling rule

Edit a scheduling rule at any time to toggle between active and inactive, and to change the start/end dates and recurrence settings.

1. In the Scheduler dialog, open a job to edit or create a new one.

2. In the left pane of the job, select Scheduling Rules.

   The defined rules appear in the right pane of the job.

3. Make any preferred changes directly within the scheduling rules grid.

Delete a scheduling rule

Delete a scheduling rule at any time. If a job has no active scheduling rules, it is not processed unless it is manually run.

1. In the Scheduler dialog, open a job to edit.
2. Select the Scheduling Rules section of the job, and then select the rule that you want to delete.

3. On the Job tab of the Scheduler ribbon, in the Scheduling Rules group, click Remove Selected.

   Alternatively, if you want to delete all scheduling rules for the job, click Clear All.

Any jobs in the scheduled jobs queue that were related to the deleted rule(s) are also deleted.

Scheduling rule examples

See the following schedule examples and the rules used to achieve them.

Schedule	Start/End	Day of week	Hours	Minutes
Weekdays at 11:00 PM	<optional>	1,2,3,4,5	23	0
Every 15 minutes	<optional>	*	*	0,15,30,45
Mondays at 11:30 PM	<optional>	1	23	30
One time (6/30/2023) at 1:30 PM (Option 1)	Start: 06/30/2023 00:00 End: 07/01/2023 00:00	*	13	30
One time (6/30/2023) at 1:30 PM (Option 2)	Start: 06/30/2023 13:30 End: 06/30/2023 13:30	*	*	*
Every Wednesday in July at noon	Start: 07/01/2023 00:00 End: 08/01/2023 00:00	3	12	0
Continuous	<optional>	*	*	*

To schedule a job to run monthly, create twelve active scheduling rules, one for each month. This is necessary because scheduling rules do not have a property for day of month, so it is not possible to use a single scheduling rule to create a monthly schedule. In the following example, the job runs on the first day of each month at 3:30 AM.

When you save the job, the rules are evaluated and the first scheduled run is placed on the schedule—in this example, the January 1 run. After that scheduled run is complete, the rules will be evaluated again, which causes the next scheduled run (February 1) to be placed on the schedule, and so on.