sysmail_help_queue_sp (Transact-SQL)

There are two queues in Database Mail: the mail queue and status queue. The mail queue stores mail items that are waiting to be sent. The status queue stores the status of items that have already been sent. This stored procedure allows viewing the state of the mail or status queues. If the parameter @queue_type is not specified, the stored procedure returns one row for each of the queues.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sysmail_help_queue_sp  [ @queue_type = ] 'queue_type'

Arguments

  • [ @queue_type = ] 'queue_type'
    Optional argument deletes e-mails of the type specified as the queue_type. queue_type is nvarchar(6) with no default. Valid entries are mail and status.

Return Code Values

0 (success) or 1 (failure)

Remarks

When troubleshooting Database Mail, use sysmail_help_queue_sp to see how many items are in the queue, the status of the queue, and when it was last activated.

Permissions

By default, only members of the sysadmin fixed server role can access this procedure.

Result Set

Column name Data type Description

queue_type

nvarchar(6)

The type of queue. Possible values are mail and status.

length

int

The number of mail items in the specified queue.

state

nvarchar(64)

The state of the monitor. Possible values are INACTIVE (queue is inactive), NOTIFIED (queue has been notified receipt to occur), and RECEIVES_OCCURRING (queue is receiving).

last_empty_rowset_time

DATETIME

The date and time that the queue was last empty. In military time format and GMT time zone.

last_activated_time

DATETIME

The date and time the queue was last activated. In military time format and GMT time zone.

Examples

The following example returns both the mail and status queues.

EXECUTE msdb.dbo.sysmail_help_queue_sp ;
GO

This is a sample result set has been edited for length.

queue_type length      state              last_empty_rowset_time  last_activated_time
---------- -------- ------------------ ----------------------- -----------------------
mail       0        RECEIVES_OCCURRING 2005-10-07 21:14:47.010 2005-10-10 20:52:51.517
status     0        INACTIVE           2005-10-07 21:04:47.003 2005-10-10 21:04:47.003

(2 row(s) affected)

See Also

Other Resources

Troubleshooting Database Mail
Database Mail Architecture

Help and Information

Getting SQL Server 2005 Assistance