Built-In Scheduling

Scheduling Basics

You can schedule deliverables using the built-in scheduler. Deliverables scheduled this way appear as jobs named after the deliverable.
However , you can schedule a deliverable several times as jobs with a different name, and attach one or more triggers to one job. A named job is unique.

Scheduling From the Command Line

Once you are in the command line (using startcommand.bat or startcommand.sh), connect to the runtime into which you wish to schedule a job.

To connect to the local runtime, use the command:

>connect

You can also use this command to connect to a remote runtime. Use the help command for more details about all commands.

To schedule a job with a single schedule:

>schedule delivery MY_DELIVERY cron "0 15 10 * * ? *" 

To schedule a job with different names and schedules

>schedule delivery MY_DELIVERY with name NAME1 cron "0 15 10 * * ? *" 
>schedule delivery MY_DELIVERY with name NAME1 cron "0 20 10 * * ? *" 
>schedule delivery MY_DELIVERY with name NAME2 cron "0 15 11 * * ? *" 

To schedule a job with a starting date and/or an ending date:

>schedule delivery MY_DELIVERY start "2009/12/10 12:55:22" cron "0 15 10 * * ? *"
>schedule delivery MY_DELIVERY start "2009/12/10 12:55:22" end "2009/12/25 12:55:22"  cron "0 15 10 * * ? *"

To retrieve the list of schedules for a deliverable

> get delivery schedules MY_DELIVERY
Getting schedules for MY_DELIVERY
-- Trigger Name: CRON_MY_DELIVERY-0
-- Job Name: MY_DELIVERY
[...]

Using the Trigger Name returned in the list of schedules, you can remove a schedule.

> remove trigger CRON_MY_DELIVERY-0

If you need more information about the command line:

>help

Cron Trigger Tutorial

General syntax

A Cron expression is a character string containing 6 or 7 fields separated by spaces.

These fields can contain the characters listed in this table, or a combination of them.

Field name Mandatory Authorized values Authorized special characters
Seconds YES 0-59 , - * /
Minutes YES 0-59 , - * /
Hours YES 0-23 , - * /
Day of the month YES 1-31 , - * ? / L W
Month YES 1-12 or JAN-DEC , - * /
Weekday YES 1-7 or SUN-SAT , - * ? / L #
Year NO empty, 1970-2099 , - * /

Special Characters:

Day names are not case-sensitive. This means ‘MON’ and ‘mon’ are identical.

Examples

Expression Meaning for the trigger
0 0 12 * * ? At 12 o’clock every day
0 15 10 ? * * at 10:15 every day
0 15 10 * * ? at 10:15 every day
0 15 10 * * ? * at 10:15 every day
0 15 10 * * ? 2005 at 10:15 every day of year 2005
0 * 14 * * ? Every minute, between 14:00 and 14:59, every day
0 0/5 14 * * ? Every 5 minutes from 14:00 to 14:55, every day
0 0/5 14,18 * * ? Every 5 minutes from 14:00 to 14:55, every day, and every 5 minutes from 18:00 to 18:55, every day
0 0-5 14 * * ? Every minute from 14:00 to 14:05, every day
0 10,44 14 ? 3 WED at 14:10 and 14:44 every Wednesday of the month of March
0 15 10 ? * MON-FRI at 10:15 every Monday, Tuesday, Wednesday, Thursday and Friday
0 15 10 15 * ? at 10:15 on the 15th of each month
0 15 10 L * ? at 10h15 every last day of the month
0 15 10 ? * 6L at 10:15 the last Friday of each month
0 15 10 ? * 6L 2002-2005 at 10:15 the last Friday of each month for years 2002 to 2005
0 15 10 ? * 6#3 at 10:15 the third Friday of each month
0 0 12 1/5 * ? at 12:00 every 5 days, each month, starting on the 1st
0 11 11 11 11 ? Every November 11th at 11:11