xp_trace_restartqueue (T-SQL)

Restarts a previously paused trace queue.

Syntax

xp_trace_restartqueue {queue_handle}

Arguments

queue_handle

Is an integer that represents 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.

Return Code Values

0 (success) or >1 (failure)

Result Sets

xp_trace_restartqueue returns this message:

The command(s) completed successfully.

Permissions

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

Examples

This example restarts the previously pauses trace queue definition for trace queue.

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_pausequeue @queue_handle

EXEC xp_trace_restartqueue @queue_handle

See Also