sp_add_schedule

Creates a schedule that can be used by any number of jobs.

Syntax

sp_add_schedule [ @schedule_name = ] 'schedule_name'   
   [ , [ @enabled                = ] enabled ]  
   [ , [ @freq_type              = ] freq_type ]  
   [ , [ @freq_interval          = ] freq_interval ]   
   [ , [ @freq_subday_type       = ] freq_subday_type ]   
   [ , [ @freq_subday_interval   = ] freq_subday_interval ]   
   [ , [ @freq_relative_interval = ] freq_relative_interval ]  /* Not supported */
   [ , [ @freq_recurrence_factor = ] freq_recurrence_factor ]  /* Not supported */
   [ , [ @active_start_date      = ] active_start_date ]   
   [ , [ @active_end_date        = ] active_end_date ]   
   [ , [ @active_start_time      = ] active_start_time ]   
   [ , [ @active_end_time        = ] active_end_time ]   
   [ , [ @owner_login_name       = ] 'owner_login_name' ]  
   [ , [ @schedule_uid           = ] schedule_uid OUTPUT ]  
   [ , [ @schedule_id            = ] schedule_id  OUTPUT ]  
   [ , [ @originating_server     = ] server_name ] /* internal */  

Arguments

[ @schedule_name = ] 'schedule_name'

The name of the schedule. schedule_name is sysname, with no default.

[ @enabled = ] enabled

Indicates the current status of the schedule. enabled is tinyint, with a default of 1 (enabled). If 0, the schedule is not enabled. When the schedule is not enabled, no jobs will run on this schedule.

[ @freq_type = ] freq_type

A value indicating when a job is to be executed. freq_type is int, with a default of 0, and can be one of these values.

[ @freq_interval = ] freq_interval

The days that a job is executed. freq_interval is int, with a default of 1, and depends on the value of freq_type.

[ @freq_subday_type = ] freq_subday_type

Specifies the units for freq_subday_interval. freq_subday_type is int, with a default of 0, and can be one of these values.

[ @freq_subday_interval = ] freq_subday_interval

The number of freq_subday_type periods to occur between each execution of a job. freq_subday_interval is int, with a default of 0.

Note: Interval should be longer than 10 seconds.

freq_subday_interval is ignored in those cases where freq_subday_type is equal to 1.

[ @freq_relative_interval = ] freq_relative_interval -- not supported

Not supported. A job's occurrence of freq_interval in each month, if freq_interval is 32 (monthly relative). freq_relative_interval is int, with a default of 0, and can be one of these values. freq_relative_interval is ignored in those cases where freq_type is not equal to 32.

[ @freq_recurrence_factor = ] freq_recurrence_factor -- not supported

Not supported. The number of weeks or months between the scheduled execution of a job. freq_recurrence_factor is used only if freq_type is 8, 16, or 32. freq_recurrence_factor is int, with a default of 0.

[ @active_start_date = ] active_start_date

The date on which execution of a job can begin. active_start_date is int, with a default of NULL, which indicates today's date. The date is formatted as YYYYMMDD. If active_start_date is not NULL, the date must be greater than or equal to 19900101.

After the schedule is created, review the start date and confirm that it is the correct date.

For weekly or monthly schedules, scheduler ignores if active_start_date) is in the past, and instead uses the current date. When a schedule is created using sp_add_schedule there is an option to specify the parameter _active_start_date that is the date that job execution will begin. If the schedule type is weekly or monthly and the active_start_date parameter is set to a date in the past, the active_start_date parameter is ignored and the current date will be used for active_start_date.

[ @active_end_date = ] active_end_date

The date on which execution of a job can stop. active_end_date is int, with a default of 99991231, which indicates December 31, 9999. Formatted as YYYYMMDD.

[ @active_start_time = ] active_start_time

The time on any day between active_start_date and active_end_date to begin execution of a job. active_start_time is int, with a default of 000000, which indicates 12:00:00 A.M. on a 24-hour clock, and must be entered using the form HHMMSS.

[ @active_end_time = ] active_end_time

The time on any day between active_start_date and active_end_date to end execution of a job. active_end_time is int, with a default of 235959, which indicates 11:59:59 P.M. on a 24-hour clock, and must be entered using the form HHMMSS.

[ @owner_login_name = ] 'owner_login_name'

The name of the server principal that owns the schedule. owner_login_name is sysname, with a default of NULL, which indicates that the schedule is owned by the creator.

[ @schedule_uid = ] schedule_uid OUTPUT

A unique identifier for the schedule. schedule_uid is a variable of type uniqueidentifier.

[ @schedule_id = ] schedule_id OUTPUT

An identifier for the schedule. schedule_id is a variable of type int.

[ @originating_server = ] server_name

Identified for informational purposes only. Not supported.

Result Sets

None

Remarks

Lyftron Administrative Portal provides an easy, graphical way to manage jobs, and is the recommended way to create and manage the job infrastructure.

Permissions

By default, members of the sysadmin fixed server role can execute this stored procedure. Other users must be granted ALTER ANY SCHEDULE privilege.

Examples

A. Creating a schedule The following example creates a schedule named RunOnce. The schedule runs one time, at 23:30 on the day that the schedule is created.

EXEC dbo.sp_add_schedule 
    @schedule_name = N'RunOnce',
    @freq_type = 1,  
    @active_start_time = 233000 ;

B. Creating a schedule, attaching the schedule to multiple jobs

The following example creates a schedule named "NightlyJobs". Jobs that use this schedule execute every day when the time on the server is 01:00. The example attaches the schedule to the job "RebuildCache" and "InvalidateInMemoryCaches" job.

Note: This example assumes that the job "RebuildCache" and job "InvalidateInMemoryCaches" already exist.

EXEC sp_add_schedule  
    @schedule_name = N'NightlyJobs' ,  
    @freq_type = 4,  
    @freq_interval = 1,  
    @active_start_time = 010000 ;  

EXEC sp_attach_schedule  
   @job_name = N'InvalidateInMemoryCaches',  
   @schedule_name = N'NightlyJobs' ;  

EXEC sp_attach_schedule  
   @job_name = N'RebuildCache',  
   @schedule_name = N'NightlyJobs' ;

See Also

• sp_update_schedule
• sp_delete_schedule
• sp_attach_schedule