Jobs Collection (SQL-DMO)

The Jobs collection contains Job objects referencing all SQL Server Agent jobs defined on a Microsoft® SQL Server™ installation.

Remarks

With the Jobs collection, you can:

• Create a SQL Server Agent job.
• Remove a SQL Server Agent job.
• Generate Transact-SQL scripts used as part of job administration strategy for a SQL Server installation.

For more information about creating a SQL Server Agent job, see Job Object.

To remove a SQL Server Agent job

• Use the Remove method of the Jobs collection, as in:

    oJobServer.Jobs.Remove("Northwind_Backup_Diff")

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

Set oJob = oJobServer.Jobs("Northwind_Backup_Log")

Or:

Set oJob = oJobServer.Jobs(22)

Note Creating or removing SQL Server Agent jobs by using the Jobs collection requires appropriate privilege. The 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 create jobs and schedule, execute, and remove jobs belonging to the connected login. Members of the db_owner role in msdb, or members of a role with greater privilege, can modify or delete any SQL Server Agent job.

Methods

Properties

Count Property