sp_requestpeertopologyinfo (Transact-SQL)

Applies to: SQL Server

Populates the MSpeer_topologyresponse system table with information about a peer-to-peer transactional replication topology. Execute sp_gettopologyinfo to obtain information from the table in XML format.

Transact-SQL syntax conventions

Syntax

sp_requestpeertopologyinfo
    [ @publication = ] N'publication'
    [ , [ @request_id = ] request_id OUTPUT ]
[ ; ]

Arguments

[ @publication = ] N'publication'

The name of the publication for which to perform a topology-wide status request. @publication is sysname, with no default.

[ @request_id = ] request_id OUTPUT

The ID number that is assigned to the topology status request. @request_id is an OUTPUT parameter of type int. This ID can be used by sp_gettopologyinfo.

Return code values

0 (success) or 1 (failure).

Remarks

sp_requestpeertopologyinfo is used in peer-to-peer transactional replication. Execute sp_requestpeertopologyinfo before executing sp_gettopologyinfo. These procedures are used by the Configure Peer-to-Peer Topology Wizard, but they can also be used directly if you require topology information in an XML format. If you prefer tabular results, query the MSpeer_topologyresponse system table.

Permissions

Requires membership in the sysadmin fixed server role, db_owner fixed database role, or execute permission directly on this stored procedure.