A schedule allows you to specify when to run a report, the format in which to create the output, and how it will be distributed.
Topics: |
The Basic Scheduling tool provides the ability to create a schedule for a procedure (FEX) when right-clicking a report procedure (FEX) from the portal. The WebFOCUS Client security authorization model controls whether users are authorized to access the application content stored in the Repository and the Scheduling tools.
To create a new schedule for a report procedure (FEX), navigate to the Resources tree and expand a domain to display your folders and report procedures (FEX). Right-click the report procedure (FEX) you want to schedule, point to Schedule, and then select the method to distribute the report procedure (FEX). You can distribute the report procedure (FEX) by Email, Printer, or Repository.
The Quick Access Toolbar, located at the top of the Basic Scheduling tool, is always visible no matter which options are selected. It provides access to the most commonly used functions. From the Quick Access Toolbar, you can select the ReportCaster button to access the New Distribution List, Save, Save As, Delete, and Close options. You can also access the Save, Run, and Help options from the toolbar.
Run options are available for selection from the Run drop-down list.
Note: The schedule must be saved for Run options to be available or enabled.
The Run options you can select include: Run with default traces, Run with no traces, Run with Schedule traces, and Run with Schedule and Report traces, as shown in the following image.
The Basic Scheduling tool ribbon partitions the scheduling options into the following categories:
The Actions portion of the ribbon is shown in the following image.
The Show portion of the ribbon is shown in the following image.
The Options portion of the ribbon is shown in the following image.
How to: |
This section provides the overall procedure to create a new schedule for a report procedure (FEX). Some steps in the procedure contain details on the associated options, while other steps direct you to a separate section that contains detailed descriptions of the options and additional information, such as tips in making a selection.
To save a schedule, the required information in the Properties, Recurrence, Distribution, and Notification tabs must be provided. If required schedule information is missing when you save the schedule, a message will display informing you of the schedule information that needs to be entered.
In the Distribution tab, you can adjust your distribution preferences for your schedule. The options available will change depending on whether you have selected Email, Printer, or Repository distribution. For more information, see Distribution options in the Basic Scheduling Tool.
This is a required field and a default name is provided.
Note: This is an optional field.
Normal - 3 Job Priority Level is the default.
You can set the interval to Run Once, Minutes, Hourly, Daily, Weekly, Monthly, Yearly, or at Custom intervals.
Note: To change the time setting, select either the hour or minutes and use the arrows to increase or decrease the value.
Note: This option is disabled for the Run Once, Minutes, and Hourly settings options.
For more information, see Notification Options.
Note: You can optionally click Save on the toolbar to remain in the Scheduling tool.
Topics: |
When you access the Basic Scheduling tool, the information for the Task tab options is predefined with the selected report procedure (FEX) information. You can complete the available task options, such as specifying parameter values, as well as select whether or not to burst the report.
Note: You can use parameters (amper variables) when specifying a value in the Save Report As field of a schedule. These parameters can be system variables, such as &YYMD or any amper variable for which a value is returned by the Reporting Server when the scheduled procedure is executed. To use the dot file extension separator after a variable, terminate the variable with the '|' character, for example, &YYMD|.htm. Similarly, to use the ampersand character itself, follow the ampersand with the '|' character (for example, Smith&|Jones). If a value for a parameter specified in a schedule is not returned by the Reporting Server when the procedure executes, the schedule will fail with a "No report to distribute" error. If the scheduled task is burst, you can also use the '%BURST' symbol to include the burst value in the Save Report As field.
The options available when you select the Task tab are:
Select one of the following options from the Alert Options dialog box.
Caution: Be sure that you set the schedule interval to a time period greater than the time it takes to run the scheduled procedure. When the schedule interval is less than the time it takes to run the procedure and the Delay option is selected, an alert schedule will distribute (based on the Distribution that you selected) more frequently than expected. For email distribution, this can result in unnecessary distribution of emails which can impact the business or operational goals of the alert report distribution.
Note: When editing an existing schedule, if the Override the Format Specified in the Procedure check box was selected, the list of formats will display. If you now clear the Override the Format Specified in the Procedure check box, the list of formats does not display. Conversely, if the Override the Format Specified in the Procedure check box was not selected, the list of formats will not display. If you now select the Override the Format Specified in the Procedure check box, the list of formats displays.
Topics: |
How to: |
Reference: |
You can customize a report and control its execution with parameters. When scheduling a report procedure (FEX), the schedule task Parameters section allows you to supply a value for parameters referenced in the report procedure or add a parameter to the schedule by creating a new parameter and specifying the parameter name and value.
If the scheduled procedure contains parameters for which values must be supplied at run time, these parameters are displayed in the parameters section of the scheduling tool.
In the Basic Scheduling tool, click the Parameters tab to open the Task Parameters dialog box, shown in the following image.
Parameters may have default values and may have values that can be selected from a static or dynamic list. For more information about selecting parameters in the Scheduling Task Parameters dialog box, see the examples provided in this chapter.
The following are considerations when specifying parameter values for a procedure:
ReportCaster displays global variables that are used in FILTERS defined in Master Files and referenced by a procedure. For example, if a Master File contains
FILENAME=CAR,SUFFIX=FOC VARIABLE NAME=&&COUNTRY1, USAGE=A10, DEFAULT=ENGLAND,$ FILTER FILTER1=COUNTRY EQ '&&COUNTRY1'; $
and the procedure being scheduled contains
WHERE FILTER1
then ReportCaster displays COUNTRY1 in the Parameters window.
The following image shows an example of a static parameter list for the CATEGORY parameter created in WebFOCUS InfoAssist+.
The following image shows the Task Parameters dialog box displaying the CATEGORY parameter. The CATEGORY parameter has been encoded to only use the values Coffee, Food, or Gifts. InfoAssist+, the content developer tool in WebFOCUS Business User Edition, does not allow you to set default values. Therefore, the Use Default column will always be blank.
To supply a value for a single-select parameter, select the Value field drop-down list box and choose a value. Your selected value will be shown in the value column. You can select only one value for a static single-select parameter.
The following image shows an example of a dynamic single-select parameter list for the Product parameter. This filter is created in InfoAssist+.
The following image shows the Task Parameters dialog box displaying the PRODUCT parameter. To change a parameter value, click the PRODUCT parameter in the table and change the parameter value using the Value field drop-down list in the Parameter Properties section.
The following image shows an example of a dynamic multiselect parameter list for the PRODUCT parameter. This filter is created in InfoAssist+.
The following image shows the PRODUCT parameter selected in the Task Parameters table.
In the Parameter Properties section, click the Value button to display the Parameter Value for Amper Variable dialog box, as shown in the following image.
The All Values check box is selected by default. If the All Values check box is cleared, you can select a single value, or you can select multiple values by holding down the Ctrl key.
Topics: |
How to: |
In addition to the ability to distribute sections of a single report to individual users using standard bursting, you can distribute sections of reports by using a filter with a static or dynamic multi-select parameter.
Active dashboards, which are compound reports that contain active reports, and reports that use an Excel format output, can be burst by using the parameter values saved in these reports. You can also burst Excel reports that contain a table of contents. You can burst these reports using a field other than the first BY field.
The Repeat Task for Each Selected Value check box must be selected in order to burst each parameter separately. In the Basic Scheduling tool, the Repeat Task for Each Selected Value check box is found in the Parameter Value for Amper Variable dialog box, as shown in the following image.
The values you choose are shown in the Task Parameters dialog box and placed between square brackets in the Value column to indicate their selection, as shown in the following image.
Once the schedule is run, the Distribution Server repeats the execution of the task for each parameter selected. For example, since the parameter values Japan, Italy, and France are selected, and the Repeat Task for Each Selected Parameter check box is selected, the schedule bursts the report information into three separate reports. Each report shows information related to one of the three selected parameters, as shown in the following image.
Selecting the Repeat Task for Each Selected Value check box allows you to select the Run Pre/Post-RPC Every Time check box, as shown in the following image.
The Run Pre/Post-RPC Every Time check box enables the Distribution Server to run pre-processing and post-processing procedures with each task repetition.
For example, if three parameter values are selected, and the Run Pre/Post-RPC Every Time check box is selected, pre-processing procedures run before each selected value, and post-processing procedures run after each selected value.
If you do not select this check box, pre-processing procedures execute only once before the first task is executed, and post-processing procedures execute only once after the last task is executed. This check box is cleared by default.
Note: The Run Pre/Post-RPC Every Time check box cannot be selected unless the Repeat Task for Each Selected Value check box is selected first.
The Task Parameters dialog box opens.
Once the parameter is chosen, the Parameter Properties section is populated with information about the selected parameter.
Note: For the Value button to be able to be selected, the chosen parameter must be a multiselect parameter.
The Parameter Value for Amper Variable dialog box opens.
The selected parameter values now appear in square brackets in the Task Parameters dialog box in the Value column, as shown in the following image.
When the schedule is run, it distributes a report for every burst parameter that you selected, as shown in the following image.
When you create an active dashboard or Excel compound report that contain filtered and unfiltered reports, only the filtered reports can be configured for bursting.
The following image shows two reports created in InfoAssist+ on one dashboard. The report showing MODEL, CAR, COUNTRY, and DEALER COST data has a COUNTRY filter applied, which allows the user to filter report results by country. The report showing MODEL and RETAIL_COST data does not have a filter.
When you access Task Parameters for this compound report through the scheduling tool, any edits you make to the parameter will only apply to the filtered report. Meaning, you will only be able to assign values to a parameter in the filtered report. An example of this is shown in the following image, where you can see the values that were assigned to the COUNTRY parameter.
When you schedule a compound report to be burst, and the Repeat Task for Each Selected Value check box is selected, the reports that contain filters will burst based on the parameter values selected. In the following image, the compound report is distributed into three separate burst reports, which show filtered data about W GERMANY, FRANCE, and JAPAN, respectively.
For each burst report, the first chart shows data for the selected COUNTRY value.
The following image shows the W GERMANY burst compound report.
Because no filters have been applied to the second report, the results of the second report are the same for each burst compound report. Only the report that uses the COUNTRY filter changes.
If you attempt to burst an active dashboard or Excel compound report that contains only filtered reports, all reports will be compatible with bursting.
The following images show two reports created in InfoAssist+ on one dashboard. Both reports use the same filter for the MODEL data.
When Task Parameters are accessed through the Scheduling tool for this compound report, you can specify the MODEL values for both reports.
As shown in the following image, the MODEL parameter has the filter values 3.0 SI 4 DOOR, 100 LS 2 DOOR AUTO, XJ12L AUTO, B210 2 DOOR AUTO, and 2000 SPIDER VELOCE selected.
The selected values appear in brackets in the Task Parameters dialog box, as shown in the following image.
When you schedule a compound report to be burst, and the Repeat Task for Each Selected Value check box is selected, burst reports are created based on the parameter values selected. In the following image, the compound report is distributed and burst into five separate compound reports, which show filtered data about each selected car model.
For each burst compound report, both reports show data for the selected car model. In the following image, the burst compound report showing information about the 3.0 SI 4 DOOR car model is selected. Both reports in the burst compound report only show information about the selected model.
It is important to verify that the parameters you delete when scheduling a report procedure (FEX) will be handled, as follows, so that the scheduled job will run successfully:
To delete a parameter so that it is not stored with the schedule information, highlight the parameter in the parameter table you want to delete, and click the Delete button.
How to: |
If you need to have the schedule job send a parameter and value that is not defined in the report procedure being scheduled, you can create a new parameter in the Task Parameters dialog box. Parameters referenced during processing by the Reporting Server must be assigned a value for the scheduled job to run successfully. The schedule job log report will contain information when required parameter values were not provided.
You can create parameters for a task as follows:
The Task Parameter dialog box displays, as shown in the following image.
The Name and Value boxes are populated in the Task Parameters dialog box Parameters table.
The Advanced Task Settings option in the Options group provides access to the Additional FOC Errors to be Processed as Warnings dialog box, where you can specify one or more FOCUS error message numbers, separated by a comma. If one of these FOCUS error numbers is encountered during schedule execution, ReportCaster will process it as a warning rather than an error. For example, if a FOC1517 error is generated by the procedure, add 1517 to the text box to convert this error to a warning. This means that if a report is produced, it will be distributed in spite of the FOCUS error number. It also means that this FOCUS error number will not trigger error notification if the schedule is configured to notify on error.
Note: When an accordion report is distributed through ReportCaster, an error may be generated. To prevent this, the error FOC 3330 (EXPANDBYROW: Not Supported with BORDER) can been added to the list of FOC Errors to be Processed as Warnings.
The following image shows the error FOC 3330 saved in the Additional FOC Errors to be Processed as Warnings dialog box.
Topics: |
The Distribution tab in the Basic Scheduling tool provides the options available for distributing the report output for the scheduled report procedure (FEX). You can distribute a report output using one of the following methods.
How to: |
Reference: |
When you distribute a report through email, you can include the report in the body of the email (known as an inline email message) or send it as an attachment. Only the HTML, DHTML, WP, and DOC formats can be distributed as an inline email message.
Note: You must be authorized to distribute by email in order to create a schedule that uses Email distribution.
Distributing a report as an inline email message is particularly useful when the report is distributed to mobile devices or through email systems that do not support attachments.
You can also distribute a report to a fax machine, as explained later in this section. The following image shows the email distribution options in the Distribution tab of the Basic Scheduling tool when the email method is selected.
SET FOCEXURL='hostname:port/ibi_apps/'
SET FOCHTMLURL='hostname:port/ibi_apps/ibi_html'
Styling options include:
When you create a schedule that uses email distribution, you can type email addresses in the To field, as shown in the following image.
If you type multiple email addresses in the To field, you can use a semi-colon or comma symbol between each email address, to designate how the Distribution Server delivers information.
If you use the comma symbol to separate email addresses, all email addresses are visible to every email recipient.
The following image shows the email addresses EmailA@ibi.com and EmailB@ibi.com separated by a comma.
The schedule will distribute a report named Sales_Metrics_YTD.htm to these email addresses. When you run the schedule, the log report states that one report named Sales_Metrics_YTD.htm has been distributed to both email addresses through a single email, as shown in the following image.
If you use the semi-colon symbol to separate email addresses, each recipient only sees their own email address.
The following image shows the email addresses EmailA@ibi.com and EmailB@ibi.com separated by a semi-colon.
The schedule will distribute a report named Sales_Metrics_YTD.htm to these email addresses. When you run the schedule, the log report states that two reports named Sales_Metrics_YTD.htm have been distributed to EmailA@ibi.com and EmailB@ibi.com through separate emails, as shown in the following image.
Note: You can use parameters (amper variables) when specifying values in the Email settings of a schedule. These parameters can be system variables, such as &YYMD, or any amper variable for which a value is returned by the Reporting Server when the scheduled procedure is executed. To use the dot file extension separator after a variable, terminate the variable with the '|' character (for example, &YYMD|.htm). Similarly, to use the ampersand character itself, follow the ampersand with the '|' character (for example, Smith&|Jones). If a value for a parameter specified in a schedule is not returned by the Reporting Server when the procedure executes, the schedule will fail with a "No report to distribute" error. If the scheduled task is burst, you can also use the '%BURST' symbol to include the burst value. If the Packet Email setting is Yes, the burst value will not be substituted in the Zip filename.
The Basic Scheduling tool appears.
Additionally, you can use group mail lists (defined on your mail server) with the Email Address(s) option. You can use group mail lists to distribute a report or notification to multiple recipients without having to maintain multiple email addresses in the Repository. The format of the group mail list depends on the mail server being used. For example, if you are using a Microsoft Exchange Server and your group mail list is defined as #group1, you would enter group1@listdomain in the Email Address(es) field. If the group mail list contains a space within its name, enclose the space with double quotation marks ('' ''). For more information, see your mail server administrator.
Note:
Note: If a default Mail Reply Address was not provided in the ReportCaster Configuration tool, the default Reply Address used for this field is the email address of the user that is signed to WebFOCUS. ReportCaster obtains the email address of the user from the WebFOCUS security system.
Note: You can also provide a custom default distribution message using the Email Distribution and Notification settings in the ReportCaster Configuration tool in the ReportCaster Console. This allows you to override the default message, Please see attachment(s), by enabling you to create a custom message specific to your organization. The message displays when creating a schedule using Email distribution. For more information, see ReportCaster Configuration.
You have the option of converting your distributed report into a password-protected compressed file. By default, the Add Report to Zip File check box is not selected and the report will not be compressed.
Note: Support of Unicode characters in a Zip file name and content within a Zip file on Windows 7 and Windows 2008 Server R2 requires the following hotfix from Microsoft: http://support.microsoft.com/kb/2704299/en-us. Without this hotfix, file names are corrupted after you decompress a .zip file in Windows 7 or in Windows Server 2008 R2.
How to: |
The report formats that support printing are DOC, PDF (when you configure ReportCaster to enable PDF to print and the printer has the appropriate driver), PS, and WP.
Note: You can use parameters (amper variables) when specifying a value for the Printer Name field of a schedule. These parameters can be system variables, such as &YYMD, or any amper variable for which a value is returned by the Reporting Server when the scheduled procedure is executed. To use the dot file extension separator after a variable, terminate the variable with the '|' character (for example, &YYMD|.htm). Similarly, to use the ampersand character itself, follow the ampersand with the '|' character (for example, Smith&|Jones). If a value for a parameter specified in a schedule is not returned by the Reporting Server when the procedure executes, the schedule will fail with a "No report to distribute" error. If the scheduled task is burst, you can also use the '%BURST' symbol to include the burst value.
The Basic Scheduling tool appears.
queue@printserver
where:
Is the name of the printer queue.
Is the host name or IP address of the printer.
ReportCaster can differentiate between the printer queue and the printer host name or IP address due to the presence of the '@' separator. Although ReportCaster supports specifying only the host name or IP address of the printer, we recommend that you specify both the printer queue and host name or IP address when distributing ReportCaster output to a printer. The maximum length of this field is 800 characters.
How to: |
When distributing scheduled output to Repository in the Basic Scheduling tool, specify the Repository folder location to which to distribute the report output.
Note: You must be authorized to distribute to repository in order to create a schedule that uses Repository distribution.
The best practice for recurring and burst schedules is to create and specify a different folder location for each report being distributed for the same report procedure (FEX). This is important so the security access can be defined and managed at the folder level and when opting to burst the distributed report output because the burst value is assigned as the title value to each report section that is distributed. The title value is the value that displays in the Resources tree.
When the report output is distributed using the Repository distribution option, the Day, Date, and Time information is prepended to the Save Report As value specified in the schedule task information. For example, the Schedule for the Product Packaging & Price report is assigned the default Save Report As value 'Product_Packaging_Price.htm' (blanks and special characters are replaced with an underscore character).
The report output distributed to the Repository on Monday December 19, 2011 at 1:35pm EST is assigned the description: Mon, 19 Dec 2011 01:35 PM EST Product Packaging Price.
The Basic Scheduling tool displays in a new window.
The Distribution Server adds Day, Date, and Time to the beginning of the Save Report As value specified in the Task tab.
Verify that the folder location is the folder to which you want to distribute the report output. The folder location defaults to the same folder as the report procedure (FEX) being scheduled. Users can select a different folder to distribute the report output to by clicking the Folder Location button, which will display a dialog box of the Resources tree from which a folder location can be selected, as shown in the following image.
Topics: |
The Notification tab in the Basic Scheduling tool, shown in the following image, provides the options to send a notification of the schedule status to specific email recipients.
The notification options are:
When you select the On Error or Always notification option, additional options become available.
The On Error and Always notification options are:
Tip: Use the Brief Message To option when you are sending notification to devices that have limited memory, such as pagers and cell phones. If you want to notify multiple recipients, you can use group mail lists defined on your mail server provided that you append an at sign (@) followed by a valid domain.
When you access the Basic Scheduling tool, the Title and Path Properties options are predefined for the selected report procedure (FEX). The following image displays the Properties tab in the Basic Scheduling tool.
The options within the Properties tab are:
Title. This allows you to provide a brief description of the purpose of the schedule. It is pre-populated with the title of the report procedure being scheduled when creating schedules with the Basic Scheduling tool. You can edit the title while creating the schedule or after saving the schedule from within the Schedule tools. You can also edit the title from the Properties option from the Resources tree after saving the schedule.
The title of the schedule is the default name assigned when saving the schedule. If the name value already exists in the selected tree folder, a message is displayed informing you that the name already exists. You can change the Title field in the Save dialog box, which when saved, will also update the Title field within the schedule information.
Path. This is the Repository path of the report procedure (FEX) you selected to schedule.
Summary. This allows you to insert a detailed description for the schedule. This is an optional field.
Job Priority Level. This specifies the priority the scheduled job will be given when processed by the Distribution Server. The default Job Priority Level is set to Normal - 3. However, you can use the drop-down list to set the priority level, as shown in the following image.
No Report to Distribute. This option is set to the default value configured by the Manager. To trigger error notification if no report is generated, set this value to Error. If you do not want to trigger notification when no report is generated, set this value to Warning.
Delete this schedule if it is not scheduled to run again. This check box allows you to specify that the schedule should be deleted after the scheduled job processing is completed if the schedule is not scheduled to run again. Selecting this option for schedules you will not utilize again is recommended as it will improve overall performance within the Resources tree listing folder contents and within the ReportCaster Explorer tool when listing schedules.
Topics: |
When you access the Basic Scheduling tool, the Recurrence tab options allow you to define how often to run the schedule. The following image displays the Recurrence tab in the Basic Scheduling tool.
Options that users must determine include frequency of distribution, start and end times, and Advanced interval settings. Select one of the following frequency of distribution settings:
You can assign start and end times by using the drop-down lists. When you click on the down arrow, a calendar will display that enables an authorized user to set the date for schedule distribution. Use the up and down arrows to set a specific time for schedule distribution. Alternatively, you can enter the time manually.
If the user has the privilege to set Advanced settings, check the Repeat schedule every check box to enable Advanced interval setting options. Set how often you want to repeat schedule distribution, when you want to stop distributing the schedule (Until Time), and the duration to distribute the schedule (Last For). Enter this information manually or use the up and down arrows to set parameters.
The Run Once option sets the job to execute immediately. This is the default value. You can modify the date or time if you do not want the schedule to run immediately. You can specify the date and time you want the schedule to run using the Start Schedule options, as shown in the following image.
To select a date, choose a date from the drop-down date calendar. To select a time, select either the hour or minutes, and use the up and down arrows to increase or decrease the value. Alternatively, you can enter the time manually.
The Minute(s) option sets the schedule to run every n minutes.
In the Every minute(s) field, type or select the minutes interval (1 to 59), check the days of the week on which you want to run the schedule, and select the Start and End date and time to define the time period in which the schedule will run. For example, the following image shows a schedule that will run every 30 minutes on Mondays beginning at noon May 16, 2012 and ending 6:00 PM October 30, 2012.
Tip: Selecting this option may affect system performance if you choose to run the schedule every 5 minutes or less. We recommend specifying a minimum of 30 minutes. The minute interval option is primarily for alert schedules.
The Hourly option sets the schedule to run every n hours.
In the Every hour(s) field, type or select the hours interval (1 to 24), check the days of the week on which you want to run the schedule, and select the Start and End date and time to define the time period in which the schedule will run. For example, the schedule shown in the following image will run every three hours on Mondays and Fridays beginning at noon May 16, 2012 and ending 6:00 PM October 30, 2012.
The Daily option in the Settings list sets the schedule to run every n days. In the Every day(s) field, type or select the days interval to run the schedule and select Start and End date and time to define the period in which the schedule will run. For example, the schedule shown in the following image will run every five days beginning at noon May 16, 2012 and ending 6:00 PM October 30, 2012.
You can also set a secondary run interval. For information about this setting, see Advanced Settings.
The Weekly option in the Settings list sets the schedule to run every n weeks.
In the Every week(s) field, type or select the weekly interval to run the schedule, check the days of the week on which you want to run the schedule, and select the Start and End date and time to define the time period in which the schedule will run. The following image shows a schedule that will run every two weeks on both Monday and Friday beginning at noon May 16, 2012 and ending at 6:00pm on October 30, 2012.
Note: When selecting the Weekly interval, set the Start 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 Start time is later than the current time when you save the schedule. If the 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.
You can also set a secondary run interval. For more information about this settings, see Advanced Settings.
The Monthly option sets the schedule to run every n months. You can then refine the monthly interval with one of the following options. Note that these options are mutually exclusive.
Additionally, select the Start and End date and time to define the time period in which the schedule will run. The following image shows a schedule set to run on the first Monday of every month beginning at noon May 16, 2012 and ending 6:00 PM October 30, 2012.
The following image shows a schedule set to run on the 2nd, 9th, 16th, 23rd, and 30th of every month, regardless of the day of the week on which those dates fall.
You can also select 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 Start time is later than the current time when you save the schedule. If the 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.
You can also set a secondary run interval. For information about this setting, see Advanced Settings.
The Yearly option sets the schedule to run every n years during a specific time period. The following image shows a schedule set to run every two years beginning at noon May 16, 2012 and ending 6:00 PM October 30, 2022.
You can also set a secondary run interval. For information about this setting, see Advanced Settings.
The Custom option allows you to select a set of dates that do not follow a specific pattern. For example, if you want to run a quarterly report on a different day of each quarter, then you can use the Custom run interval to set the schedule to run on dates, such as March 3 (Saturday), June 4 (Monday), September 7 (Friday), and December 2 (Sunday).
The following image shows the Custom Run Interval options, which includes Start (initially set to the current date and time) and the End date and time options, the Custom calendar, and the Custom Date List node that appears in the right panel.
Define the time period in which the schedule will run by selecting the Start date and time and the End date and time. Select the specific days on which to run the schedule by clicking the day in the calendar. (Use the forward and back buttons at the top of the calendar to move through the months and years.) As you select a date, it appears in the Custom Date List. If it does not already exist, a folder for the year and month of the date you select is automatically created under the Custom Date List node. The following image shows an example of a selection of Custom dates in the calendar and the Custom Date List.
To remove a date from the list, click the date in the calendar. The date is no longer highlighted in the calendar and will not appear in the Custom Date List. You can optionally use the left single arrow to remove a date from the list. The double arrow button removes all defined lists.
You can also set secondary run interval. For information about this setting, see Advanced Settings.
The Advanced settings option enables you to 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 and minutes or until a specified time. This option is available for schedules that run every day(s), week(s), month(s), or year(s).
Note: When a schedule is saved, the hours setting is converted to minutes. When a schedule is edited, this value appears as minutes.
The secondary run interval will not be validated when the schedule is created. Instead, validation is performed every time the next run time of the schedule is calculated when running within the secondary run interval. The secondary run interval cannot exceed the next run time for the primary run interval. For example, a daily schedule cannot have a secondary run interval greater than Every 1 day(s). If you schedule a secondary run interval to run after the next primary run interval of the schedule, the secondary run interval is stopped and an error message appears. This error message is also written to the log file.
The Advanced settings section allows you to specify repeat options, as well as time intervals. The following image shows an example of set secondary run interval options.
The Apply secondary run interval options are:
Note: When a schedule is updated, the next run time is recalculated based only on the primary run interval. This means that if a schedule that includes a secondary run interval is updated before the secondary schedule is able to run, then the secondary run interval is ignored and the NEXTRUNTIME is calculated based on the primary interval.
For example, a schedule exists that is set to run daily at 2:00 PM with a secondary run interval of every 10 minutes from 2:00 PM to 3:00 PM. When the schedule runs at 2:00 PM, the NEXTRUNTIME resets to run at 2:10, which honors the secondary run interval. If this schedule is updated at 2:03 PM, the NEXTRUNTIME is recalculated to be 2:00 PM the next day, rather than 2:10 PM on the current day.
WebFOCUS | |
Feedback |