BusinessObjects Enterprise Administrator's Guide

Run options and parameters

This section describes the Run parameters for scheduling an object. Not all parameters apply in all cases, but when they apply, their function is the same.

Run

This list always appears, but the options vary depending on which recurrence pattern you select.

For example, if you select Daily, you can select to run the object "Once each day" or "Every X day(s)." If you select Monthly, you can select to run the object "On the Nth day of the month" or "On the first Monday of the month." To see all the Run options for a recurrence pattern, refer to the software.

X and N variables

Applies to certain Daily and Monthly recurrence patterns only. When you select a Run option that contains these variables, the system displays their default values. You can then changes these values as needed.

For example, if you select the "Daily" recurrence pattern and the "Every X hour(s), N minute(s)" Run option, you could specify to run the report every 4 (X) hours and 30 (N) minutes. If you don't change the X or N value, the system will run the report every hour.

Start Date

Applies to most, but not all recurrence patterns and Run options. The default is the current date and time. The system will run the object according to the schedule that you specified, as soon as it can, after the Start Date has passed.

For example, if you specify a start date that is three months into the future, the system won't run the object until the start date has passed, even if all the other criteria are met. After that, the system will run the report at the specified time.

End Date

Applies to most, but not all, recurrence patterns and Run options. The default is the current time and a date in the distant future, to ensure an object will be run indefinitely. Specify a different End Date if required. Once the End Date has passed, the system no longer runs the object.

Available Events

Applies to all Run options that include "with events." Select an event and click the Add button to move it to the "Events to wait for" box. You can select one or several events. The system will run the object only when those events have been successfully completed. See also Scheduling an object with events.

Available Schedule Events

Applies to all Run options that include "with events." Select an event and click the Add button to move it to the "Events to trigger on completion" box. You can select one or several events. A successful run of the object will trigger the events that you specified. This list of events contains schedule events only. You cannot trigger file or custom events. See also Scheduling an object with events, and Chapter 18: Managing Events.

Number of retries allowed

Always applies. The number of times the system attempts to process an object if the first attempt is not successful. By default, the number is zero.

Retry interval in seconds

Always applies. The period, in seconds, that the system will wait before it attempts to process the object again if the first attempt is unsuccessful.