xp_trace_setqueueautostart (T-SQL)

Configures the specified trace queue for automatic startup on the server’s next restart. There is no maximum number of automatic start trace queues.

Syntax

xp_trace_setqueueautostart {'queue_name', autostart_value}

Arguments

'queue_name'

Is a string specifying the trace queue name. This name can be determined by executing xp_trace_enumqueuedefname and must be a shared trace queue definition.

autostart_value

Is a Boolean value that tells Microsoft® SQL Server™ whether the specified trace queue should be automatically started on the next server restart (1) or not (0).

Return Code Values

0 (success) or >1 (failure)

Result Sets

xp_trace_setqueueautostart returns this message:

The command(s) completed successfully.

Remarks

Only shared queue definitions can be autostarted.

Permissions

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

Examples

This example configures the London Events trace queue for autostart.

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_savequeuedefinition @queue_handle,

    'London Events',

    1

EXEC xp_trace_setqueueautostart 'London Events',

    1

See Also