Jaa


JobSchedule.FrequencyInterval Property

Gets or sets the frequency interval, which determines how often the job is scheduled to run.

Namespace: Microsoft.SqlServer.Management.Smo.Agent
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Property FrequencyInterval As Integer
public int FrequencyInterval { get; set; }
public:
property int FrequencyInterval {
    int get ();
    void set (int value);
}
/** @property */
public int get_FrequencyInterval ()

/** @property */
public void set_FrequencyInterval (int value)
public function get FrequencyInterval () : int

public function set FrequencyInterval (value : int)

Property Value

An Int32 value that specifies the frequency interval.

Remarks

FrequencyInterval is always interpreted relative to the value of the FrequencyTypes property. FrequencyInterval is interpreted using these values.

FrequencyInterval value

FrequencyType value

FrequencyInterval is not applicable.

FrequencyType.Unknown

FrequencyInterval is not applicable. The schedule runs once only.

FrequencyType.OneTime

An integer value that specifies the number of days. For example, when FrequencyInterval property is 3, the schedule job runs every third day.

FrequencyType.Daily

A bit flag long integer value that specifies the days of the week using the WeekDays enumeration.

WeekDays.Sunday = 1

WeekDays.Monday = 2

WeekDays.Tuesday = 4

WeekDays.Wednesday = 8

WeekDays.Thursday = 16

WeekDays.Friday = 32

WeekDays.Saturday = 64

WeekDays.WeekDays = 62

WeekDays.WeekEnds = 65

WeekDays.EveryDay = 127

Combine values using an OR logical operator to set more than a single day. For example, combine WeekDays.Monday and WeekDays.Friday (FrequencyInterval = 2 + 32 = 34) to schedule an activity for Monday and Friday.

FrequencyType.Weekly

An integer that specifies the ordinal day of the month on which the schedule is active. For example, 4 specifies the fourth day of the month.

FrequencyType.Monthly

A long integer that specifies the day of the week. This property is used together with the FrequencyRelativeIntervals property, which specifies the ordinal number of the specified day of the week that occurs within the month. For example, if FrequencyRelativeIntervals property is set to 2 and the FrequencyInterval is set to Friday, the scheduled job runs on the second Friday of every month.

FrequencyType.MonthlyRelative

FrequencyInterval is not applicable. The schedule runs when Microsoft SQL Server is started.

FrequencyType.AutoStart

FrequencyInterval is not applicable. The schedule runs when the processor running the instance of SQL Server is idle.

FrequencyType.OnIdle

FrequencyInterval is not applicable.

FrequencyType.Valid

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

How to: Create a Job with Steps and a Schedule in Visual Basic .NET

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

JobSchedule Class
JobSchedule Members
Microsoft.SqlServer.Management.Smo.Agent Namespace

Other Resources

Scheduling Automatic Administrative Tasks in SQL Server Agent
Automating Administrative Tasks (SQL Server Agent)
sp_add_schedule (Transact-SQL)