Share via


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.

Applies To:

Job Object