EmailLevel 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 EmailLevel property specifies the job completion status that causes an e-mail notification to a specified operator.
Syntax
object
.EmailLevel [=value]
Parts
object
An expression that evaluates to an object in the Applies To list.value
Specifies a job completion status as described in Settings.
Settings
Value |
Description |
|---|---|
SQLDMOComp_All |
SQLDMOComp_Always. |
SQLDMOComp_Always |
Sends e-mail regardless of success or failure. |
SQLDMOComp_Failure |
Sends e-mail if the job failed to complete. |
SQLDMOComp_None |
Ignores any completion status. It does not send e-mail when the job completes. |
SQLDMOComp_Success |
Sends e-mail if the job completes successfully. |
Remarks
To configure a SQL Server Agent job to notify an operator of job completion, set the OperatorToEmail property to the operator name, and then set the EmailLevel property to the required response.
Data Type
Long, enumerated
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetEmailLevel(SQLDMO_COMPLETION_TYPE* pRetVal);
HRESULT SetEmailLevel(SQLDMO_COMPLETION_TYPE NewValue);