Share via


UpdateNotification Method

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 UpdateNotification method configures SQL Server Agent operator notification for alerts raised.

Syntax

object.UpdateNotification(AlertOrOperator,NotificationType)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • AlertOrOperator
    String that specifies a SQL Server Agent alert or operator by name as described in Settings.

  • NotificationType
    Long integer that specifies a notification method as described in Settings.

Prototype (C/C++)

HRESULT UpdateNotification(
SQLDMO_LPCSTR AlertOrOperatorName,
SQLDMO_NOTIFY_TYPE NotifyMethod);

Settings

When setting the AlertOrOperator argument of the UpdateNotification method of the Alert object, the string identifies an existing operator by name. When setting the argument for the Operator object method, the string identifies an existing alert by name.

Set NotificationType by using these values.

Constant

Value

Description

SQLDMONotify_All

7

Notification by e-mail, e-mail sent to the pager address, and network pop-up message.

SQLDMONotify_Email

1

Notification by e-mail sent to the operator e-mail address.

SQLDMONotify_NetSend

4

Notification by network pop-up message posted to the operator network address

SQLDMONotify_None

0

No notification method specified for the referenced operator.

SQLDMONotify_Pager

2

Notification by e-mail sent to the operator pager address.

Remarks

The AddNotification method associates operators with alerts. Operators designated receive notification messages when an event raising an alert occurs. When an alert is raised, notification can be sent using e-mail, network pop-up message, or pager. The AddNotification method allows specification of one or more notification mechanisms when operators are assigned notification for an alert.

The RemoveNotification method removes all operator notification mechanisms for an alert. Use the UpdateNotification method to alter the notification mechanism without dropping the association between an alert and operator.