PendingInstructions Property
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The PendingInstructions property returns a count of SQL Server Agent target server maintenance tasks awaiting download by the target server.
Syntax
object
.PendingInstructions
Parts
- object
An expression that evaluates to an object in the Applies To list
Data Type
Long
Modifiable
Read-only
Prototype (C/C++)
HRESULT GetPendingInstructions(LPLONG pRetVal);
Remarks
An instance of SQL Server acting as the master server for multiserver administration initiates tasks that create, modify, and delete jobs and job steps for target servers. Other tasks start or stop running jobs, coordinate polling, and so on. A target server polls its master server, retrieving and performing the tasks posted.
Due to polling, there is a lag between master server task assignment and its implementation by the target server. For example, a master server could delete a job step within a multiserver job. When the target server polls, it retrieves the task, an instruction to delete the job step, and the master server is altered, indicating that the pending instruction has been retrieved.