Edit

Share via

sp_delete_maintenance_plan_job (Transact-SQL)

  • Article

Applies to: SQL Server

Disassociates the specified maintenance plan from the specified 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_delete_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 with which the maintenance plan is associated. @job_id is uniqueidentifier, and must be a valid ID.

Return code values

0 (success) or 1 (failure).

Remarks

sp_delete_maintenance_plan_job must be run from the msdb database.

When all jobs are removed from the maintenance plan, you should run sp_delete_maintenance_plan_db to remove the remaining databases from the plan.

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 deletes the job B8FCECB1-E22C-11D2-AA64-00C04F688EAE from the maintenance plan.

EXEC sp_delete_maintenance_plan_job
    N'FAD6F2AB-3571-11D3-9D4A-00C04FB925FC',
    N'B8FCECB1-E22C-11D2-AA64-00C04F688EAE';

Related content