Create an Operator

Applies to: SQL Server Azure SQL Managed Instance

Important

On Azure SQL Managed Instance, most, but not all SQL Server Agent features are currently supported. See Azure SQL Managed Instance T-SQL differences from SQL Server for details.

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

Before You Begin

Limitations and Restrictions

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

  • Note that 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.

Security

Permissions

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

Using SQL Server Management Studio

To create an operator

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

  2. Click 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:

    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:

    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, click OK.

Using Transact-SQL

To create an operator

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

  2. On the Standard bar, click New Query.

  3. Copy and paste the following example into the query window and click Execute.

    -- sets up the operator information for user 'danwi.'
    -- The operator is enabled.   
    -- SQL Server Agent sends notifications by pager 
    -- from Monday through Friday from 8 A.M. to 5 P.M.  
    USE msdb ;  
    GO  
    
    EXEC 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 (Transact-SQL).