Skip to content

sp-replqueuemonitor-transact-sql.md

Latest commit

 

History

History
78 lines (61 loc) · 3.54 KB

sp-replqueuemonitor-transact-sql.md

File metadata and controls

78 lines (61 loc) · 3.54 KB
title sp_replqueuemonitor (Transact-SQL) | Microsoft Docs
ms.custom
ms.date 03/14/2017
ms.prod sql-server-2016
ms.reviewer
ms.suite
ms.technology
replication
ms.tgt_pltfrm
ms.topic language-reference
applies_to
SQL Server
f1_keywords
sp_replqueuemonitor
sp_replqueuemonitor_TSQL
helpviewer_keywords
sp_replqueuemonitor
ms.assetid 6909a3f1-43a2-4df5-a6a5-9e6f347ac841
caps.latest.revision 25
author BYHAM
ms.author rickbyh
manager jhubbard

sp_replqueuemonitor (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Lists the queue messages from a [!INCLUDEmsCoName] [!INCLUDEssNoVersion] queue or [!INCLUDEmsCoName] Message Queuing for queued updating subscriptions to a specified publication. If [!INCLUDEssNoVersion] queues are used, this stored procedure is executed at the Subscriber on the subscription database. If Message Queuing is used, this stored procedure is executed at the Distributor on the distribution database.

Topic link icon Transact-SQL Syntax Conventions

Syntax

  
sp_replqueuemonitor [ @publisher = ] 'publisher'  
    [ , [ @publisherdb = ] 'publisher_db' ]  
    [ , [ @publication = ] 'publication' ]  
    [ , [ @tranid = ] 'tranid' ]  
    [ , [ @queuetype = ] 'queuetype' ]

Arguments

[ @publisher = ] 'publisher'
Is the name of the Publisher. publisher is sysname, with a default of NULL. The server must be configured for publishing. NULL for all Publishers.

[ @publisherdb = ] 'publisher_db' ]
Is the name of the publication database. publisher_db is sysname, with a default of NULL. NULL for all publication databases.

[ @publication = ] 'publication' ]
Is the name of the publication. publicationis sysname, with a default of NULL. NULL for all publications.

[ @tranid = ] 'tranid' ]
Is the transaction ID. tranidis sysname, with a default of NULL. NULL for all transactions.

[@queuetype= ] 'queuetype' ]
Is the type of queue that stores transactions. queuetype is tinyint with a default of 0, and can be one of these values.

Value Description
0 All types of queues
1 Message Queuing
2 [!INCLUDEssNoVersion] queue

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_replqueuemonitor is used in snapshot replication or transactional replication with queued updating subscriptions. The queue messages that do not contain SQL commands or are part of a spanning SQL command are not displayed.

Permissions

Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_replqueuemonitor.

See Also

Updatable Subscriptions for Transactional Replication
System Stored Procedures (Transact-SQL)