Skip to content

Latest commit

 

History

History
135 lines (94 loc) · 5.36 KB

create-an-operator.md

File metadata and controls

135 lines (94 loc) · 5.36 KB
Raw
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords monikerRange
Create an Operator
Create an Operator
markingmyname
maghan
01/19/2017
sql
ssms
how-to
SQL Server Agent jobs, operators
jobs [SQL Server Agent], notification options
operators (users) [Database Engine], creating with Management Studio
SQL Server Agent jobs, notification options
jobs [SQL Server Agent], operators
notifications [SQL Server], job status
= azuresqldb-mi-current || >= sql-server-2016

Create an Operator

[!INCLUDE SQL Server SQL MI]

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 [!INCLUDEmsCoName] [!INCLUDEssNoVersion] Agent jobs in [!INCLUDEssnoversion] by using SQL Server Management Studio or [!INCLUDEtsql].

Before You Begin

Limitations and Restrictions

  • The Pager and net send options will be removed from [!INCLUDEssNoVersion] Agent in a future version of [!INCLUDEmsCoName] [!INCLUDEssNoVersion]. 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 [!INCLUDEssNoVersion] Agent sends messages to the pager.

    Workday end
    Select the time of day after which [!INCLUDEssNoVersion] 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 [!INCLUDEssDE].

  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).