xp_trace_setseverityfilter (T-SQL)

Specifies the severity filter, or the minimum and maximum event severity levels to capture for the events specified. Microsoft® SQL Server™ captures the required information, configured by executing xp_trace_seteventclassrequired, for all events with a severity level greater than the minimum severity value, if any, and less than the maximum severity level, if any.

Syntax

xp_trace_setseverityfilter {queue_handle, minimum_severity,
    maximum_severity}

Arguments

queue_handle

Is an integer representing the handle for the trace queue. queue_handle is used to reference the trace queue and is placed in an output parameter by xp_trace_addnewqueue.

minimum_severity

Is an integer specifying the minimum severity for which to trace. There is no default value. If 0, there are no minimum restrictions. The maximum value is 4294967295.

---

Note Obtain severity levels from the sysmessages system table.

---

maximum_severity

Is an integer specifying the maximum severity for which to trace. There is no default value. If 0, there are no maximum restrictions. The maximum value is 4294967295.

Return Code Values

0 (success) or >1 (failure)

Result Sets

xp_trace_setseverityfilter returns this message:

The command(s) completed successfully.

Permissions

Execute permissions for xp_trace_setseverityfilter default to members of the sysadmin fixed server role but can be granted to other users.

Examples

This example configures the severity filter value information for trace queue. A minimum severity level of 14 is specified, and a maximum severity level of 25 is specified.

USE master

DECLARE @queue_handle int, @column_value int

SET @column_value = 16|32|8192|128|512

EXEC xp_trace_addnewqueue 1000,

    5,

    95,

    90,

    @column_value,

    @queue_handle OUTPUT

EXEC xp_trace_setseverityfilter @queue_handle,

    14,

    25

See Also