MSXEnlist Method
The MSXEnlist method initiates SQL Server Agent participation as a target for multiserver administration.
Applies To
| JobServer Object |
Syntax
object.MSXEnlist( MasterServer , Location )
Parts
object
Expression that evaluates to an object in the Applies To list.
MasterServer
String naming a registered instance of Microsoft® SQL Server™ 2000.The instance must be configured as a multiserver administration master server.
Location
String documenting the enlisting server's location. Used for user assistance only.
Prototype (C/C++)
HRESULT MSXEnlist(
SQLDMO_LPCSTR szServer,
SQLDMO_LPCSTR szLocation);
Remarks
For SQL Server, multiserver administration participation is configured by performing two tasks. An instance of SQL Server declares itself a multiserver administration master server (MSX) by creating an administering operator. One or more instances of SQL Server then enlist with the configured MSX, becoming administration target servers (TSX).
SQL Server multiserver administration is implemented using a hub and spoke topology. An MSX cannot enlist as a target of any other MSX in an organization.
An instance of SQL Server participating as a TSX cannot become the target of any other MSX by using the MSXEnlist method. Use the MSXDefect method to break an existing master-target relationship prior to enlisting the target server in a new multiserver administration group.
Important Only instances of SQL Server version 7.0 running on Microsoft Windows NT® 4.0 or Microsoft Windows 2000® can enlist as target servers.