• Article

AlertCategories Collection

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 AlertCategories collection contains Category objects that reference SQL Server Agent alert categories.

SQL-DMO object model that shows the current object

Remarks

With the AlertCategories collection, you can create and maintain names that group Microsoft SQL Server alerts.

The AlertCategories collection contains, at a minimum, a Category object named [Uncategorized] and one named Replication.

To create an alert category

  1. Create a Category object.

  2. Set the Name property of the Category object. Alert category names are unique on a server running SQL Server.

  3. Add the Category object to the AlertCategories collection of a connected JobServer object.

To remove an alert category

  • Use the Remove method of the AlertCategories collection of a connected JobServer object. Indicate the targeted alert category using the category name or the ordinal location in the collection, as in:

    oJobServer.AlertCategories.Remove("Northwind")

Note

Alerts are re-categorized as necessary when an alert category is removed. Any alerts previously exhibiting the removed category exhibit the category [Uncategorized] after the Remove method completes.