sp_add_maintenance_plan_job (Transact-SQL)
Applies to: SQL Server
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 don't 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 SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
Transact-SQL syntax conventions
Syntax
sp_add_maintenance_plan_job
[ @plan_id = ] N'plan_id'
, [ @job_id = ] N'job_id'
[ ; ]
Arguments
[ @plan_id = ] N'plan_id'
Specifies the ID of the maintenance plan. @plan_id is uniqueidentifier, and must be a valid ID.
[ @job_id = ] N'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
This stored procedure is owned by the db_owner role. You can grant EXECUTE
permissions for any user, but these permissions may be overridden during a SQL Server upgrade.
Examples
This example adds the job B8FCECB1-E22C-11D2-AA64-00C04F688EAE
to the maintenance plan created using sp_add_maintenance_plan_job
.
EXEC sp_add_maintenance_plan_job
@plan_id = N'FAD6F2AB-3571-11D3-9D4A-00C04FB925FC',
@job_id = N'B8FCECB1-E22C-11D2-AA64-00C04F688EAE';