Alert Object

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 Alert object represents a single SQL Server Agent alert. Alerts respond to either specific Microsoft SQL Server error messages or SQL Server errors of a specified severity.

SQL-DMO object model that shows the current object

Remarks

You can use the Alert object to create and manage SQL Server Agent alerts:

  • Create an alert to respond to a specific SQL Server error.

  • Change the properties of an existing alert to modify its behavior.

  • Change the notified operators on an instance of the error condition.

The Name property of an Alert object uses the SQL Server data type sysname. The string must be a unique value for each Alert object in the Alerts collection.

SQL Server does not allow the creation of more than one alert on any given error condition or severity level. More than one alert can be defined on a specific message identifier; however, each alert defined must be limited in scope by associating the alert with a specific database.

SQL Server alerts are enabled by default. However, an alert created with the minimum required values will fire no notifications. You must assign operators to the alert by using the AddNotification method of the Alert or Operator object.

To create an alert

  1. Create an Alert object.

  2. Set the Name property.

  3. Set the response type for the alert by setting the value of the Severity property or the MessageIDproperty.

  4. Set any optional properties you want. For example, set the DatabaseName property to limit the alert's action to a specific database, or use the AddNotification method to add operators to the alert.

  5. Add the Alert object to the Alerts collection of a connected JobServer object.

To alter an existing alert

  1. Get an Alert object from the Alerts collection of a connected JobServer object.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the Alert object properties to reflect changes in alert behaviors.

  4. Use the DoAlter method to submit the alert changes to SQL Server.

See Also

Reference

Concepts