sp_msx_enlist

Transact-SQL Reference

Transact-SQL Reference

sp_msx_enlist

Adds the current server to the list of target servers available for multiserver operations. Only a Microsoft® SQL Server™ version 7.0 database server running on Windows NT® can be enlisted.

Caution  sp_msx_enlist edits the registry. Manual editing of the registry is not recommended because inappropriate or incorrect changes can cause serious configuration problems for your system. Therefore, only experienced users should use the Registry Editor program to edit the registry. For more information, see the Microsoft® Windows NT® or Microsoft Windows® 95 documentation.

Syntax

sp_msx_enlist [@msx_server_name =] 'msx_server'
    [, [@location =] 'location']

Arguments

[@msx_server_name =] 'msx_server'

Is the name of the multiserver administration server (master server) to add. msx_server is nvarchar(30), with no default.

[@location =] 'location'

Is the location of the target server that is enlisting. location is nvarchar(100), with a default of NULL.

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Permissions

Only members of the sysadmin fixed server role can execute sp_msx_enlist.

Examples

This example enlists the current server into the LONDON2 master server.

USE msdb
EXEC sp_msx_enlist 'LONDON2', 
   'Paris Subsidiary, Bldg 21, Room 309, Rack 5'

See Also

sp_msx_defect

System Stored Procedures

xp_cmdshell