QUERY JOB (Consultar un trabajo)

Editar en línea

Utilice este mandato para mostrar información sobre uno o más trabajos. La información puede incluir ID de trabajo y estados. Puede consultar trabajos después de iniciar una regla de almacenamiento de copia, división o réplica. Además, puede consultar trabajos de conjunto de retención, incluidos los trabajos para copiar un conjunto de retención en el almacenamiento de cinta. Puede filtrar la lista de trabajos que se visualizan especificando un ID de trabajo u otros atributos de trabajo.

Clase de privilegio

Cualquier administrador puede emitir este mandato.

Sintaxis

Parámetros

ID_trabajo

Especifica el ID del trabajo a consultar. El ID de trabajo es un número exclusivo que se asigna automáticamente cuando se inicia el trabajo. Si especifica un ID de trabajo, sólo se tiene en cuenta ese trabajo durante el proceso de consultas y no tiene que especificar otros parámetros. Este parámetro es opcional.

Sugerencia: Para determinar el ID de un trabajo, emita el mandato QUERY JOB sin especificar otros parámetros. Se incluyen ID de trabajo en la salida, junto con los nombres de trabajo asociados. Cuando se inicia una regla de almacenamiento o se crea un conjunto de retención, se muestra también un mensaje que indica el número de trabajo en el registro de actividad.

PEERid

Especifica el ID del trabajo correspondiente en el servidor asociado, que puede ser un servidor de réplica de origen o un servidor de réplica de destino. Este parámetro es opcional. Este parámetro solo se utiliza para trabajos de reglas de almacenamiento de réplica.

Status

Especifica el estado de un trabajo. Sólo se muestran los trabajos que coinciden con el estado especificado. Si no especifica un estado, se visualizarán los trabajos con todos los estados. Este parámetro es opcional. Puede seleccionar uno de los valores siguientes:

ANy: Visualiza todos los trabajos. Éste es el valor predeterminado.
Running: Visualiza todos los trabajos que están en ejecución. Cuando un trabajo empieza a ejecutarse, el estado del trabajo se establece automáticamente en RUNNING y una indicación de fecha y hora que la hora inicial de la ejecución del trabajo se almacena en la base de datos. Si especifica STATUS=RUNNING, se muestran todos los trabajos que tienen el estado RUNNING, INTERRUPTING o TERMINATING.
Sugerencia: Si ejecuta el mandato INTERRUPT JOB en un trabajo en ejecución, el trabajo se ejecuta con un estado de INTERRUPTING. Si ejecuta el mandato TERMINATE JOB en un trabajo en ejecución, el trabajo se ejecuta con un estado TERMINATING. Cuando un trabajo deja de ejecutarse, se detienen los procesos activos y la información del trabajo se actualiza con una hora y un estado de finalización.
Completed: Visualiza todos los trabajos que se han completado correctamente sin errores.
Interrupted: Muestra todos los trabajos que se han interrumpido debido a un error o porque se ha emitido el mandato INTERRUPT JOB . Cuando un trabajo tiene el estado INTERRUPTED, los valores ENDDATE y ENDTIME están en blanco en la salida del trabajo porque el trabajo no se ha completado.
Sleeping: Visualiza todos los trabajos de copia en cinta que se encuentran en un estado SLEEPING. Cuando un trabajo no termina de copiar un conjunto de retención u otros datos en la cinta durante el tiempo asignado, el trabajo está en el estado SLEEPING. Un trabajo permanece en un estado SLEEPING hasta que la regla de almacenamiento inicie de nuevo la operación de copia en cinta.
Terminated: Visualiza todos los trabajos de copia en cinta que han sido terminados por el servidor o por un administrador que ha emitido el mandato TERMINATE JOB. No se puede reiniciar un trabajo terminado.

BEGINDate

Especifica la fecha inicial en un rango de fechas de trabajo. Se muestran los trabajos que se han iniciado a partir de esta fecha. El valor predeterminado es la fecha más antigua posible en la que se ha iniciado el primer trabajo. Si especifica una hora pero no especifica una fecha inicial, se utilizará la fecha más antigua posible. Si no especifica una fecha u hora iniciales, se consultarán todos los trabajos desde la fecha más antigua posible hasta la hora actual. Este parámetro es opcional.

Puede especificar la fecha utilizando uno de los valores siguientes:

Valor	Descripción	Ejemplo
MM/DD/AAAA	Una fecha específica	15/05/2018
TODAY	La fecha actual	TODAY
TODAY +días o +días	La fecha actual más el número de días especificados	TODAY+3 o +3
TODAY-días o -días	La fecha actual menos el número de días especificados	TODAY-3 o -3
EOLM (fin del mes pasado)	El último día del mes anterior	EOLM
EOLM-días	El último día del mes anterior menos el número de días especificados	EOLM-1 Incluir trabajos que se han iniciado un día antes del último día del mes anterior
BOTM (Principios de este mes)	El primer día del mes actual	BOTM
BOTM +días	El primer día del mes actual, más el número de días especificados	BOTM+9 Incluir trabajos que se han iniciado el día 10 del mes actual

BEGINTime

Especifica la hora inicial en un rango de horas de trabajo. Se muestran los trabajos que se han iniciado a partir de esta hora. Este parámetro es opcional. El valor predeterminado es 00:00:00.

Puede especificar la hora utilizando uno de los valores siguientes:

Valor	Descripción	Ejemplo
HH:MM:SS	Una hora concreta	15:30:08
NOW	La hora actual	NOW
NOW+HH:MM o +HH:MM	La hora actual más el número especificado de horas y minutos	NOW+02:00 o +02:00
NOW-HH:MM o -HH:MM	La hora actual menos el número especificado de horas y minutos	NOW-02:00 o –02:00

ENDDate

Especifica la fecha de finalización en un rango de fechas de trabajo. Se muestran los trabajos que han terminado hasta esta fecha (incluida). Este parámetro es opcional. El valor predeterminado es la fecha del día de hoy.

Puede especificar la fecha utilizando uno de los valores siguientes:

Valor	Descripción	Ejemplo
MM/DD/AAAA	Una fecha específica.	15/05/2018
TODAY	La fecha actual.	TODAY
TODAY +días o +días	La fecha actual más el número de días especificados. El número máximo de días que puede especificar es de 9999.	TODAY+3 o +3
TODAY-días o -días	La fecha actual menos el número de días especificados.	TODAY-3 o -3
EOLM (fin del mes pasado)	El último día del mes anterior.	EOLM
EOLM-días	El último día del mes anterior menos el número de días especificados.	EOLM-1 Incluir trabajos que han finalizado un día antes del último día del mes anterior
BOTM (Principios de este mes)	El primer día del mes actual.	BOTM
BOTM +días	El primer día del mes actual, más el número de días especificados.	BOTM+9 Incluir trabajos que han finalizado el día 10 del mes actual

ENDTime

Especifica la hora de finalización del rango de horas de trabajo. Se muestran los trabajos que han terminado hasta esta hora (incluida). Este parámetro es opcional. El valor predeterminado es la hora actual.

Puede especificar la hora utilizando uno de los valores siguientes:

Valor	Descripción	Ejemplo
HH:MM:SS	Una hora concreta	15:30:08
NOW	La hora actual	NOW
NOW+HH:MM o +HH:MM	La hora actual más el número especificado de horas y minutos	NOW+02:00 o +02:00
NOW-HH:MM o -HH:MM	La hora actual menos el número especificado de horas y minutos	NOW-02:00 o –02:00

Ejemplo: mostrar información acerca de todos los trabajos

Visualizar información sobre todos los trabajos. Consulte Descripciones de campo para obtener las descripciones de campo.

query job

Job ID    Peer Job ID   Job Type    Job Name      Begin Date/Time        End Date/Time         Run Date/Time          Status    
-------   -----------   --------    ----------    -------------------    -------------------   -------------------    ---------
35                      RetSet      YEARLY        05/07/2018 08:41:48    05/07/2018 08:41:49                          Completed
36                      RetSet      QUARTERLY     05/07/2018 08:44:48    05/07/2018 08:44:49                          Completed
37                      RetSet      QUARTERLY     05/07/2018 08:45:18    05/07/2018 08:45:19                          Completed
42                      RuleCopy    COPYRULE1     05/13/2018 22:18:46    05/13/2018 22:18:47                          Completed
46                      RetSet      WEEKLY        05/14/2018 08:44:50    05/14/2018 08:44:52                          Completed
47                      RuleTier    TIERRULE3     05/14/2018 08:45:20    05/14/2018 08:45:22                          Completed
82                      RuleCopy    COPYRULE2     05/21/2018 17:09:25    05/21/2018 17:09:26                          Completed
91                      RuleCopy    COPYRULE3     05/25/2018 07:00:14    05/25/2018 07:00:18                          Completed
93                      RetSet      WEEKLY        05/25/2018 13:00:19    05/25/2018 13:00:22                          Completed
241       531           RuleRepl    REPLRULE      12/21/2021 17:34:09                          12/21/2021 18:34:09    Running

Ejemplo: mostrar información acerca de todos los trabajos en ejecución

Mostrar información sobre todos los trabajos que se están ejecutando actualmente. Esta incluye todos los trabajos que tienen los estados RUNNING, INTERRUPTING o TERMINATING. Consulte Descripciones de campo para obtener las descripciones de campo.

query job status=running

Job ID   Peer Job ID  Job Type   Job Name      Begin Date/Time       End Date/Time         Run Date/Time          Status
-------  -----------  --------   ----------    -------------------   -------------------   --------------------   --------
210                   RetSet     YEARLY        10/14/2019 08:30:19                         10/15/2019 09:44:51    Running
211                   RuleTier   TIERRULE3     10/14/2019 08:35:27                                                Running
213                   RetSet     WEEKLY        10/14/2019 08:39:22                         10/15/2019 08:40:17    Running
243      541          RuleRepl   REPLRULE      12/21/2021 17:34:09                         12/21/2021 18:34:09    Running

Ejemplo: Mostrar información sobre un trabajo y su trabajo de igual

Mostrar información sobre un trabajo de réplica con el ID de trabajo 531 y su trabajo de igual, con el ID 241. Consulte Descripciones de campo para obtener las descripciones de campo.

La salida de trabajo siguiente procede del servidor de réplica de origen.

query job 531 peerid=241

Job ID    Peer Job ID   Job Type   Job Name     Begin Date/Time     End Date/Time        Run Date/Time         Status
-------   -----------   --------   ----------   -----------------   -----------------    -------------------   ---------
531       241           RuleRepl   REPLPHX      12/21/21 18:02:30   12/21/21 18:03:51                          Completed

La salida de trabajo siguiente procede del servidor de réplica de destino correspondiente.

>phoenix-dr: query job 241 peerid=531

Job ID   Peer Job ID   Job Type   Job Name     Begin Date/Time      End Date/Time        Run Date/Time         Status
-------  -----------   --------   ----------   -------------------  -------------------  -------------------   ---------
241      531           RuleRepl   (Inbound)    12/21/21 18:02:30    12/21/21 18:04:00                          Completed
                                  REPLPHX
				  from
			          PRIMARY

Descripciones de los campos

ID de trabajo

ID numérico exclusivo que está asociado con el trabajo.

ID de trabajo de igual

El ID de trabajo del trabajo de réplica correspondiente en el servidor asociado.

Tipo de trabajo

El tipo de trabajo. Son posibles los tipos de trabajo siguientes:

RetSet: Especifica un trabajo de creación de conjuntos de retención.
RuleCopy: Especifica que el trabajo se ha creado iniciando una regla de almacenamiento de copia.
RuleTier: Especifica que el trabajo se ha creado iniciando una regla de almacenamiento de clasificación.
RuleRepl: Especifica que el trabajo se ha creado iniciando una regla de almacenamiento de réplica.

Nombre de trabajo

Nombre del trabajo. Para los trabajos de creación de conjuntos de retención, el nombre de trabajo es el nombre de la regla de retención utilizada para crear el conjunto de retención. Para trabajos de reglas de almacenamiento de división, copia y réplica, el nombre del trabajo es el nombre de la regla de almacenamiento.

Si el mandato QUERY JOB se emite en el servidor de réplica de destino, el campo Job Name muestra un valor de (Entrada), seguido de los nombres de la regla de almacenamiento y el servidor de réplica de origen.

En Ejemplo, bajo el campo Job Name, REPLPHX es el nombre de la regla de almacenamiento y PRIMARY es el nombre del servidor de réplica de origen.

Fecha/hora de inicio

La fecha y la hora en que se inició el trabajo.

Fecha/Hora final

Fecha y hora a la que finalizó el trabajo.

Fecha/Hora de ejecución

Fecha y hora más recientes en que empezó la ejecución del trabajo de creación de conjuntos de retención. Este valor está en blanco cuando todos los procesos que están asociados con el trabajo se detienen. Para los trabajos de creación de conjunto de retención, el valor del campo Run Date/Time puede diferir del valor Begin Date/Time si el trabajo de creación de conjunto de retención se ha interrumpido y reanudado.

Restricción: Este campo sólo se aplica a trabajos de conjunto de retención. Para los trabajos de reglas de almacenamiento, el campo Run Date/Time está en blanco.

Estado

Estado del trabajo.

Sugerencia: Para ver trabajos con un estado de INTERRUPTING o TERMINATING, debe especificar STATUS=RUNNING en la consulta. Con este filtro, se visualizarán todos los trabajos con un estado RUNNING, INTERRUPTING y TERMINATING.

Mandatos relacionados

Tabla 1. Mandatos relacionados con QUERY JOB
Mandato	Descripción
TRABAJO DE INTERRUPT	Interrumpe un trabajo en un estado de ejecución.
REANUDAR TRABAJO	Reanuda un trabajo interrumpido.
TERMINAR TRABAJO	Finaliza un trabajo en un estado interrumpido o de inactividad.