Important: This document is currently under construction. None of the features described in this document are available; development is in progress.

Using the Scheduler

Action sequences are able to perform small tasks from displaying a message to bursting thousands of reports as part of a larger work flow. With such a wide range of functionality, a subscription does not make sense for all types of content. For example, you would not want users subscribing to an action sequence that starts a burst job for instance. A more typical subscription is an action sequence that runs a report and emails the result to a user. When a piece of content is defined as being something to which a user can subscribe, a Subscribe button appears on the parameter page when a user executes that action sequence.

To manage what content a user subscribes to, you must define the action sequences that are available for subscription. Each action sequence defined may be assigned a set of schedules from which a user can choose. The Scheduler allows you to create schedules and associate them action sequences.

Scheduled misfires are handled according to a set of predefined rules.

Entering Schedules in the Schedule Creator Dialog Box

Enter schedules associated with your action sequences in the Schedule Creator dialog box. The Schedule Creator makes it easy for you to enter schedules without having to worry about creating CRON expressions; however, it provides you with the option to enter CRON expressions if that is your preference.

Follow the instructions below to use the Schedule Creator:

1. In the main page of the Pentaho Open Admin Console, click Administration.

1. Click the Scheduler tab.

1. In the scheduler click first icon on the left to open the Scheduler Creator dialog box.

1. Under Schedule, enter a Name for the schedule, for example, Monthly Sales.

1. Enter a Group associated with the schedule, for example, Sales Schedules.

1. Enter a short Description of the schedule. for example, "Schedule runs on the first of each month, schedule runs on Monday of each week."

1. Select a Recurrence Type. You can schedule the action sequence to run once at a particular date and time only, or have it recur in seconds, minutes, hours, daily, weekly, monthly, or yearly, based on a Cron string. The options under the Recurrence Editor change depending on the recurrence type you select.

1. Click OK.

Note: You can use the Schedule Creator to enter a Cron expression manually by selecting Cron from the Recurrence Type list. See CRON Expressions in Detail to learn more about CRON expressions.

Adding the Action Sequences

After you add your schedules, you must associate them with action sequence. Follow the instructions below to enter the paths to the action sequences:

1. Under Scheduled Action, enter the path to each action sequence separated by commas.

1. Click OK.

Examining the List of Schedules

As you create new schedules, the schedules appear in a list box. By examining the list, you can identify the Name and Group associated with each schedule. You can also determine the status (State) of each schedule and read a brief description of the schedule. In addition, you can determine when the schedule was first run (Fire Time - Last/Next) and when it will run again. The icons on the top left corner of the Scheduler page allow you to perform tasks such as:

• Create  - Allows you to create a schedule

• Edit  - Allows you to edit the details of a schedule

• Delete  - Allows you to delete a specified schedule; however, if the schedule is currently executing in a scheduler thread it continues to execute but no new instances are run

• Suspend  - Allows you to pause a specified schedule. Once the job is paused the only way to start it again is with a Resume

• Resume  - Allows you to resume a previously suspended schedule. Once the schedule is resumed the Scheduler applies misfire rules if needed

• Run -  Allows you to run a schedule