sp_help_jobs_in_schedule (Transact-SQL)

Devuelve información sobre los trabajos a los que está adjunta una programación concreta.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_jobs_in_schedule 
     [ @schedule_name = ] 'schedule_name' ,
     [ @schedule_id = ] schedule_id

Argumentos

• [ @schedule_id = ] schedule_id
  Identificador de la programación de la que se va a mostrar información. schedule_id es de tipo int y no tiene valor predeterminado. Puede especificarse schedule_id o schedule_name.

• [ @schedule_name = ] 'schedule_name'
  Nombre de la programación de la que se va a mostrar información. schedule_name es de tipo sysname y no tiene valor predeterminado. Puede especificarse schedule_id o schedule_name.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Devuelve el siguiente conjunto de resultados:

Nombre de columna	Tipo de datos	Descripción
job_id	uniqueidentifier	Id. único del trabajo.
originating_server	nvarchar(30)	Nombre del servidor del que proviene el trabajo.
name	sysname	Nombre del trabajo.
enabled	tinyint	Indica si el trabajo está habilitado para su ejecución.
description	nvarchar(512)	Descripción del trabajo.
start_step_id	int	Id. del paso del trabajo en el que debe comenzar la ejecución.
category	sysname	Categoría del trabajo
owner	sysname	Propietario del trabajo.
notify_level_eventlog	int	Máscara de bits que indica en qué circunstancias se debe registrar un evento de notificación en el registro de aplicación de Microsoft Windows. Puede ser uno de los valores siguientes: 0 = Nunca 1 = Cuando el trabajo se realiza correctamente 2 = Cuando se produce un error en el trabajo 3 = Cuando el trabajo se completa (independientemente del resultado del trabajo)
notify_level_email	int	Máscara de bits que indica en qué circunstancias se debe enviar una notificación por correo electrónico cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog.
notify_level_netsend	int	Máscara de bits que indica en qué circunstancias se debe enviar un mensaje de red cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog.
notify_level_page	int	Máscara de bits que indica en qué circunstancias se debe enviar un mensaje a un localizador cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog.
notify_email_operator	sysname	Nombre de correo electrónico del operador que recibe la notificación.
notify_netsend_operator	sysname	Nombre del equipo o del usuario que se utiliza al enviar mensajes de red.
notify_page_operator	sysname	Nombre del equipo o del usuario que se utiliza al enviar un mensaje a un localizador.
delete_level	int	Máscara de bits que indica en qué circunstancias se debe eliminar un trabajo cuando se completa. Los valores posibles son los mismos que para notify_level_eventlog.
date_created	datetime	Fecha de creación del trabajo.
date_modified	datetime	Fecha en que se modificó el trabajo por última vez.
version_number	int	Versión del trabajo (se actualiza automáticamente cada vez que el trabajo se modifica).
last_run_date	int	Fecha de inicio de la última ejecución del trabajo.
last_run_time	int	Hora de inicio de la última ejecución del trabajo.
last_run_outcome	int	Resultado de la última ejecución del trabajo: 0 = No realizado 1 = Realizado 3 = Cancelado 5 = Desconocido
next_run_date	int	Fecha de la próxima ejecución programada del trabajo.
next_run_time	int	Hora de la próxima ejecución programada del trabajo.
next_run_schedule_id	int	Número de identificación de la próxima ejecución programada.
current_execution_status	int	Estado de ejecución actual.
current_execution_step	sysname	Paso actual de ejecución del trabajo.
current_retry_attempt	int	Si el trabajo se está ejecutando y el paso se ha intentado más de una vez, es el número actual de reintentos.
has_step	int	Número de pasos que tiene el trabajo.
has_schedule	int	Número de programaciones que tiene el trabajo.
has_target	int	Número de servidores de destino que tiene el trabajo.
tipo	int	Tipo de trabajo: 1 = Trabajo local. 2 = Trabajo multiservidor. 0 = El trabajo no tiene servidores de destino.

Comentarios

Este procedimiento muestra información acerca de los trabajos adjuntos a la programación especificada.

Permisos

De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros del rol fijo de servidor sysadmin. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para obtener detalles sobre los permisos de estos roles, vea Roles fijos de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole solo pueden ver el estado de los trabajos que les pertenecen.

Ejemplos

En el ejemplo siguiente se muestran los trabajos adjuntos a la programación NightlyJobs.

USE msdb ;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs' ;
GO

Vea también

Referencia

Procedimientos almacenados del Agente SQL Server (Transact-SQL)

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_detach_schedule (Transact-SQL)