Create an operator

Applies to: SQL Server Azure SQL Managed Instance

This article describes how to configure a user to receive notifications about SQL Server Agent jobs in SQL Server by using SQL Server Management Studio or Transact-SQL.

Limitations

The Pager and Net send options will be removed from SQL Server Agent in a future version of SQL Server. Avoid using these features in new development work, and plan to modify applications that currently use these features.

SQL Server Agent must be configured to use Database Mail to send e-mail and pager notifications to operators. For more information, see Assign Alerts to an Operator.

SQL Server Management Studio provides an easy, graphical way to manage jobs, and is the recommended way to create and manage the job infrastructure.

Permissions

Only members of the sysadmin fixed server role can create operators.

Use SQL Server Management Studio

1. In Object Explorer, select the plus sign to expand the server where you want to create a SQL Server Agent operator.

2. Select the plus sign to expand SQL Server Agent.

3. Right-click the Operators folder and select New Operator.

   The following options are available on the General page of the New Operator dialog box:

   Option	Description
   Name	Change the name of the operator.
   Enabled	Enable the operator. When not enabled, no notifications are sent to the operator.
   E-mail name	Specifies the e-mail address for the operator.
   Net send address	Specify the address to use for net send.
   Pager e-mail name	Specifies the e-mail address to use for the operator's pager.
   Pager on duty schedule	Sets the times at which the pager is active.
   Monday - Sunday	Select the days that the pager is active.
   Workday begin	Select the time of day after which SQL Server Agent sends messages to the pager.
   Workday end	Select the time of day after which SQL Server Agent no longer sends messages to the pager.

   The following options are available on the Notifications page of the New Operator dialog box:

   Option	Description
   Alerts	View the alerts in the instance.
   Jobs	View the jobs in the instance.
   Alert list	Lists the alerts in the instance.
   Job list	Lists the jobs in the instance.
   E-mail	Notify this operator using e-mail.
   Pager	Notify this operator by sending e-mail to the pager address.
   Net send	Notify this operator using net send.

4. When finished creating the new operator, select OK.

Use Transact-SQL

1. In Object Explorer, connect to an instance of Database Engine.

2. On the Standard bar, select New Query.

3. Copy and paste the following example into the query window and select Execute. This example sets up the operator information for user danwi. The operator is enabled, and then SQL Server Agent sends notifications by pager from Monday through Friday from 8 A.M. to 5 P.M.

   USE msdb;
   GO
   
   EXECUTE dbo.sp_add_operator
       @name = N'Dan Wilson',
       @enabled = 1,
       @email_address = N'danwi',
       @pager_address = N'5551290AW@pager.Adventure-Works.com',
       @weekday_pager_start_time = 080000,
       @weekday_pager_end_time = 170000,
       @pager_days = 62;
   GO
   

For more information, see sp_add_operator.