PageLevel Property

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 PageLevel property controls SQL Server Agent operator page notification on job completion.

Syntax

object.PageLevel [= value]

Parts

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

  • value
    A long integer that specifies a completion status as described in Settings.

Data Type

Long, enumerated

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetPageLevel(SQLDMO_COMPLETION_TYPE* pRetVal);
HRESULT SetPageLevel(SQLDMO_COMPLETION_TYPE NewValue);

Settings

Constant

Value

Description

SQLDMOComp_All

6

Pages the operator regardless of success or failure.

SQLDMOComp_Always

3

Pages the operator regardless of success or failure.

SQLDMOComp_Failure

2

Pages the operator when job fails to complete successfully.

SQLDMOComp_None

0

Ignores any completion status. It does not page the operator.

SQLDMOComp_Success

1

Pages the operator on successful completion.

SQLDMOComp_Unknown

4096

The value is not valid.

Remarks

SQL Server Agent can send notification of job completion using e-mail, network pop-up message, or pager.

To enable a job for pager notification

  1. Set the OperatorToPage property to the name of an existing SQL Server Agent operator.

  2. Set the PageLevel property to control Microsoft SQL Server network pop-up message notification based on job completion.

Applies To:

See Also

Reference