sp_help_targetserver (Transact-SQL)

Applies to: SQL Server

Lists all target servers.

Transact-SQL syntax conventions

Syntax

sp_help_targetserver [ [ @server_name = ] N'server_name' ]
[ ; ]

Arguments

[ @server_name = ] N'server_name'

The name of the server for which to return information. @server_name is sysname, with a default of NULL.

Return code values

0 (success) or 1 (failure).

Result set

If @server_name isn't specified, sp_help_targetserver returns this result set.

Column name Data type Description
server_id int Server identification number.
server_name nvarchar(30) Server name.
location nvarchar(200) Location of the specified server.
time_zone_adjustment int Time zone adjustment, in hours, from Greenwich mean time (GMT).
enlist_date datetime Date of the specified server's enlistment.
last_poll_date datetime Date the server was last polled for jobs.
status int Status of the specified server.
unread_instructions int Specifies whether the server has unread instructions. If all rows are downloaded, this column is 0.
local_time datetime Local date and time on the target server, which is based on the local time on the target server as of the last poll of the master server.
enlisted_by_nt_user nvarchar(100) Microsoft Windows user that enlisted the target server.
poll_interval int Frequency in seconds with which the target server polls the master SQLServerAgent service in order to download jobs and upload job status.

Permissions

To execute this stored procedure, a user must be a member of the sysadmin fixed server role.

Examples

A. List information for all registered target servers

The following example lists information for all registered target servers.

USE msdb;
GO

EXEC dbo.sp_help_targetserver;
GO

B. List information for a specific target server

The following example lists information for the target server SEATTLE2.

USE msdb;
GO

EXEC dbo.sp_help_targetserver N'SEATTLE2';
GO