sp_manage_jobs_by_login

Transact-SQL Reference

Transact-SQL Reference

sp_manage_jobs_by_login

Deletes or reassigns jobs that belongs to the specified login.

Syntax

sp_manage_jobs_by_login [@action =] 'action'
    [, [@current_owner_login_name =] 'current_owner_login_name']
    [, [@new_owner_login_name =] 'new_owner_login_name']

Arguments

[@action =] 'action'

Is the action to take for the specified login. action is varchar(10), with no default. When action is DELETE, sp_manage_jobs_by_login deletes all jobs owned by current_owner_login_name. When action is REASSIGN, all jobs are assigned to new_owner_login_name.

[@current_owner_login_name =] 'current_owner_login_name'

Is the login name of the current job owner. current_owner_login_name is sysname, with no default.

[@new_owner_login_name =] 'new_owner_login_name'

Is the login name of the new job owner. Use this parameter only if action is REASSIGN. new_owner_login_name is sysname, with a default of NULL.

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Permissions

Only members of the sysadmin fixed server role can execute sp_manage_jobs_by_login.

Examples

This example reassigns all jobs from janetl to stevenb.

USE msdb
EXEC sp_manage_jobs_by_login 'REASSIGN', 'janetl', 'stevenb'

See Also

sp_delete_job

System Stored Procedures