Share via

  • Article

sp_add_maintenance_plan_job (Transact-SQL)

Associates a maintenance plan with an existing job.

Note

This stored procedure is used with database maintenance plans. This feature has been replaced with maintenance plans which do not use this stored procedure. Use this procedure to maintain database maintenance plans on installations that were upgraded from a previous version of SQL Server.

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. 

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_add_maintenance_plan_job [ @plan_id = ] 'plan_id' , [ @job_id = ] 'job_id'

Arguments

  • [ @plan_id =] 'plan_id'
    Specifies the ID of the maintenance plan. plan_id is uniqueidentifier, and must be a valid ID.

  • [ @job_id =] 'job_id'
    Specifies the ID of the job to be associated with the maintenance plan. job_id is uniqueidentifier, and must be a valid ID. To create a job or jobs, execute sp_add_job, or use SQL Server Management Studio.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_add_maintenance_plan_job must be run from the msdb database.

Permissions

Only members of the sysadmin fixed server role can execute sp_add_maintenance_plan_job.

Examples

This example adds the job "B8FCECB1-E22C-11D2-AA64-00C04F688EAE" to the maintenance plan created by using sp_add_maintenance_plan_job.

EXECUTE   sp_add_maintenance_plan_job N'FAD6F2AB-3571-11D3-9D4A-00C04FB925FC', N'B8FCECB1-E22C-11D2-AA64-00C04F688EAE'