Schedule parameters

This section describes the parameters that you can use to specify when to run a job.

You use a series of fields to specify the times for a job to run.

Field

Description

Range

Minutes

The number of minutes.

0-59

Hours

The hour in the day.

0-23

Dates (Day of Month)

The day of the month.

1-31

Months

The month of the year.

1-12

Days (Weekday)

The day of the week (Sunday = 0).

0-6

The numeric values you enter in the fields can be represented as follows:

  • Use an asterisk (*) to denote all valid values in the range. An asterisk can be followed by a forward slash (/) and a step value. For example, a value of */2 in the Hours field runs the job every 2 hours.
    Note: Asterisk is interpreted specially in the Dates and Days fields. It matches its meaning in the UNIX/Linux cron facility. If one field has a literal value and the other has an asterisk, then only the frequency for the literal value is used. For example, if Month is *, Dates is *, and Days is 1, the execution occurs every Monday. See also the Day/Date examples below.
  • Use a range of numbers separated by a hyphen. For example, 8-11 in the Hours field specifies hours 8, 9, 10 and 11. You can follow a range by a forward slash (/) and a step value. For example, 0-23/2 in the Hours field runs the job every other hour.
  • Use a comma-separated list of a set of numbers (or ranges) separated by commas. For example, 1, 2, 3-5, 8.

The schedule is constructed from the values specified for the fields. Examples:

Values

Desired schedule

Minutes

Hours

Dates

Months

Days

Run job daily, at 5 p.m.

0

17

*

*

*

Run job weekly, every Monday at 4:30 p.m.

30

16

*

*

1

Run job every half hour on every week day, skip weekends

*/30

*

*

*

1-5

Run job at 12:30 a.m., every other day

30

0

*/2

*

*

The Days and Dates fields use asterisks in a special way.
  • If one has an asterisk value but the other has a literal value, the job runs according to the field having a literal setting.
  • If both have non-asterisk values, then the job runs when either condition occurs.
  • If both have asterisk values, then the job runs every day.

Days/Dates examples:

Values

Desired schedule

Minutes

Hours

Dates

Months

Days

Run job at 1:01 a.m. on the first day of each month. Dates uses a literal value; Days uses an asterisk.

1

1

1

*

*

Run job at 1:01 a.m. on every Monday in the month. Dates uses an asterisk; Days uses a literal value.

1

1

*

*

1

Run job at 1:01 a.m. on every Monday in the month and on the first day of the month regardless of whether that day is a Monday. Both Dates and Days use a literal value.

1

1

1

*

1

Run job at 1:01 a.m. every day. Both Dates and Days use an asterisk value.

1

1

*

*

*