DeleteLevel Property
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.
The DeleteLevel property controls post-execution processing for SQL Server Agent jobs.
Syntax
object
.DeleteLevel [=value]
Parts
object
An expression that evaluates to an object in the Applies To list.value
A long integer that specifies a job completion status as described in Settings.
Data Type
Long, enumerated
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetDeleteLevel(SQLDMO_COMPLETION_TYPE* pRetVal);
HRESULT SetDeleteLevel(SQLDMO_COMPLETION_TYPE NewValue);
Settings
Constant |
Value |
Description |
|---|---|---|
SQLDMOComp_All |
6 |
Deletes regardless of success or failure. |
SQLDMOComp_Always |
3 |
Deletes regardless of success or failure. |
SQLDMOComp_Failure |
2 |
Deletes on failed completion. |
SQLDMOComp_None |
0 |
The default. It ignores any completion status. It does not delete. |
SQLDMOComp_Success |
1 |
Deletes on successful completion. |
Remarks
If directed, SQL Server Agent can delete a job definition when execution succeeds or fails. By default, jobs are not deleted when execution completes, regardless of the success or failure of the job.
Set the DeleteLevel property to control agent deletion of jobs after execution.