JobSchedule Class

  • Article

The JobSchedule class represents a SQL Server Agent job schedule.

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

Syntax

'Declaration
Public NotInheritable Class JobSchedule
    Inherits ScheduleBase
    Implements IAlterable, ICreatable, IDroppable, IRenamable, _
    IScriptable

public sealed class JobSchedule : ScheduleBase, IAlterable, ICreatable, IDroppable, 
    IRenamable, IScriptable

public ref class JobSchedule sealed : public ScheduleBase, IAlterable, ICreatable, IDroppable, 
    IRenamable, IScriptable

public final class JobSchedule extends ScheduleBase implements IAlterable, ICreatable, 
    IDroppable, IRenamable, IScriptable

public final class JobSchedule extends ScheduleBase implements IAlterable, ICreatable, 
    IDroppable, IRenamable, IScriptable

Remarks

SQL Server Agent jobs can be scheduled for execution by using SQL Server Agent. Scheduling jobs automates job execution when SQL Server Agent is enabled but jobs are not required to be scheduled. They can be executed on demand by a sufficiently privileged user. Jobs can have more than one active schedule and SQL Server Agent evaluates all schedules to determine when to run the job. With the JobSchedule object, you can:

  • Create a schedule for a SQL Server Agent job.

  • Remove a schedule from an existing SQL Server Agent job.

  • Manage job schedules either by enabling a schedule or adjusting run times or frequencies.

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

To get or set JobSchedule object properties, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be the owner of the job, or be a member of the sysadmin fixed server role.

To create a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.

To drop a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.

Inheritance Hierarchy

System.Object
   Microsoft.SqlServer.Management.Smo.SmoObjectBase
     Microsoft.SqlServer.Management.Smo.SqlSmoObject
       Microsoft.SqlServer.Management.Smo.NamedSmoObject
         Microsoft.SqlServer.Management.Smo.Agent.AgentObjectBase
           Microsoft.SqlServer.Management.Smo.Agent.ScheduleBase
            Microsoft.SqlServer.Management.Smo.Agent.JobSchedule

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 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)