Share via


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.

Applies To: