Schedule Options

WebFOCUS Online Help > ReportCaster End User > Creating a Schedule > Schedule Options

Schedule Options

In this section:

Creating a Secondary Run Interval

How to:

Specify Schedule Options

When you access the ReportCaster Scheduling Wizard, the Schedule window opens first.

The following image shows the Schedule window, which is where you specify the job description, the run intervals, the date and time you want the schedule to run, and to enable or disable the schedule. You can select the schedule to run once or repeatedly on any day at any time.

Procedure: How to Specify Schedule Options

Specify the following schedule information:

In the Description field, type a descriptive name that identifies the schedule. After the schedule runs, the description appears in your list of schedules.

From the Schedule Job drop-down list, select how frequently you want the schedule to run. Possible values are:
- hour(s). If you want to run the schedule every n hours. Type a range between 1 and 24 hours, and then check the days of the week on which you want to run the schedule.
  The following image shows, in the Schedule Job pane, that the scheduled job will run every 3 hours on Monday and Friday.
- day(s). If you want to run the schedule every n days.
  The following image shows, in the Schedule Job pane, that the scheduled job will run every 5 days.
- week(s). If you want to run the schedule every n weeks. Type a number that specifies how often you want to run the schedule (for example, every 2 weeks), and then check the days of the week on which you want to run the schedule.
  The following image shows, in the Schedule Job pane, that the scheduled job will run every two weeks on both Monday and Friday.
  
  Note: When selecting the week(s) interval, set the Start Date to the date of the first day (current or future) of the week you want the schedule to run. If you select the current date, then you must make sure that the schedule Start Time is later than the current time when you save the schedule. If the schedule Start Time is less than or equal to the current time, the calculation for the next run time results in the schedule not running on the current date.
- Month(s). If you want to run the schedule every n months. You can select to schedule a job every nth day of the week every n months (for example, the first Monday every 2 months), or on specific days every n months.
  The following image shows a schedule that will run on the first Monday of every month. Although other dates are selected on the calendar, they are inactive since the ' Day(s)' and 'The nth day of the month(s)' options are mutually exclusive.
  
  The following image shows a schedule that will run on the 2nd, 9th, 16th, 23rd, and 30th every month. The schedule will not run on the first Monday of every month.
  
  You can also click the Last Day of the Month option at the end of the calendar to run the schedule on the last day of the month.
  
  Note: When selecting the Month(s) interval, set the Start Date to the date of the first day (current or future) of the month you want the schedule to run. If you select the current date, then you must make sure that the schedule Start Time is later than the current time when you save the schedule. If the schedule Start Time is less than or equal to the current time, the calculation for the next run time results in the schedule not running on the current date.
- year(s). If you want to run the schedule every n years.
  The following image shows, in the Schedule Job pane, that the scheduled job will run every 2 years.

Optionally, select the Apply secondary run interval check box if you want to create a secondary run interval within the day the schedule runs. This option is only available for schedules that run every day(s), week(s), month(s), or year(s). For more information, see Creating a Secondary Run Interval.
In the Start Date field, specify the date on which you want the schedule to begin. You can type this value in the field using the format MM/DD/YYYY, or you can click the calendar and then select the date. The current date is the default Start Date.

In the Start Time field, using the drop-down lists, specify the time you want the schedule to begin. The current time is the default Start Time. The start time applies only to the Start Date and does not apply to any date thereafter. If you select a time that is after the current time, the scheduled job is not run until the next instance of the Start Time that fits within the specifications of the schedule.

In the End Date field, specify the date on which you want the schedule to end. You can type this value in the field using the format MM/DD/YYYY, or you can click the calendar and then select the date. 12/31/2099 is the default End Date. The default End Date is configurable using the ReportCaster Server Configuration tool. If you want the Scheduling Wizard to display a different default End Date, contact your ReportCaster Administrator. This field does not display for a schedule job that will only be run once.

In the End Time field, using the drop-down lists, specify the time you want the schedule to end. 11:59 PM is the default End Time. The default End Time is configurable using the ReportCaster Server Configuration tool. If you want the Scheduling Wizard to display a different default End Time, contact your ReportCaster Administrator. This field does not display for a schedule job that will only be run once.

Uncheck the Enabled (Scheduled jobs run at specified time) check box if you want the schedule to be inactive.

Check Delete job if it is not scheduled to run again if you want the schedule to run once and not be stored in the ReportCaster Repository.

Click Next on the bottom of the Schedule window to continue scheduling the report:
- If you selected the Apply secondary run interval check box, you are sent to the optional Apply secondary run interval window. For more information, see Creating a Secondary Run Interval.
- If you did not select the Apply secondary run interval check box, you are sent to the Report Information window. For more information, see Report Information.

Creating a Secondary Run Interval

In the Apply secondary run interval window, you can optionally create a secondary run interval within the day the schedule runs. You can apply the secondary run interval every n minutes or hours for a specified number of hours/minutes or until a specified time. This option is available for schedules that run every day(s), week(s), month(s), or year(s). The following image shows the secondary run interval options:

The following options appear In the Apply secondary run interval window:

Every n [minutes|hours]. Applies the secondary run interval every n minutes or hours (in this example every 10 minutes) within the day the schedule runs.
Until Time. The time up until which the secondary run interval will be applied. In this example, the schedule will be rerun every 10 minutes until 4:00 P.M.
Lasts for n hour(s) n minute(s). The duration, specified in hours/minutes, during which the secondary run interval will be applied. This option and the Until time option are mutually exclusive, so this option is inactive in this example.

Note: The secondary run interval will not be validated when the schedule is created. Instead, validation is performed every time the schedule's NEXTRUNTIME is calculated when running within the secondary run interval. The secondary run interval cannot exceed the NEXTRUNTIME for the primary run interval. For example, a daily schedule cannot have a secondary run interval greater than Every 1 day(s). If a secondary run interval is scheduled to run after the schedule's next primary run interval, the secondary run interval is stopped and an error message is displayed to the user and written to the log file.

Click Next on the bottom of the Apply secondary run interval window to continue to the Report Information window. For more information, see Report Information.

WebFOCUS