JobSteps Collection (SQL-DMO)

The JobSteps collection contains JobStep objects defining the administrative tasks automated by a SQL Server Agent job.

Remarks

When using SQL-DMO to create and manage a SQL Server Agent job, an administrative task, called a step, is referenced by a single JobStep object. Adding a JobStep object to the JobSteps collection adds the task to the referenced job, allowing automated task execution.

With the JobSteps collection, you can:

For more information about configuring job tasks by adding a JobStep object to or removing it from the JobSteps collection, see Job Object and JobStep Object.

When using the Item or Remove method, the JobSteps collection supports member identification using either name or ordinal reference syntax. For example:

Set oJobStep = oJob.JobSteps("DBCC_CHECKDB_Northwind")

  

Or:

Set oJobStep = oJob.JobSteps(3)

  


Note Defining SQL Server Agent job steps by using the JobSteps collection requires appropriate privilege. The Microsoft® SQL Server™ login used for SQLServer object connection must be a member of the fixed role public in the system database msdb. With public membership, the connection may add steps to, and remove steps from, jobs belonging to the connected login. Members of the db_owner role in msdb, or members of a role with greater privilege, can modify any SQL Server Agent job.


Methods
Add Method Refresh Method
Item Method Remove Method (Collections)
ItemByID Method  

Properties

Count Property


(c) 1988-98 Microsoft Corporation. All Rights Reserved.