17.10 - list_tasks - Teradata Data Mover

Teradata® Data Mover Guía del usuario

Product
Teradata Data Mover
Release Number
17.10
Release Date
Junio de 2021
Content Type
Guía del usuario
Publication ID
B035-4101-061K-ESN
Language
Español (España)

Propósito

Las tareas son específicas de cada utilidad y son ejecutadas por el agente de Data Mover. Desde una perspectiva de nivel superior, esta vista identifica las tareas que utilizan recursos relacionados con las tareas de Data Mover, como por ejemplo las ranuras de tareas de agente, las ranuras de carga, etc. Desde una perspectiva de nivel de trabajo, identifica los trabajos que están bloqueando un trabajo en particular y la cantidad de retraso antes de la ejecución.

Parámetros

Consulte Orden de parámetros.

agent_name
[Opcional] Nombre del agente.
AgentA
dm.rest.endpoint
[Opcional] Introduzca una URL del servidor REST de Data Mover para sobrescribir el valor predeterminado especificado en el archivo commandline.properties para conectarse a un servidor REST diferente (y, por lo tanto, a un daemon diferente) en tiempo de ejecución.
https://dm-server1:1443/datamover
frequency
[Opcional] Frecuencia de actualización del estado en segundos.
Ejemplo: 5
job_name
Ejemplo: [Opcional] Supervisa las tareas relacionadas con el trabajo.
12315DFHJKS
security_password
[Opcional] Contraseña del superusuario o del usuario autorizado de Viewpoint.
Ejemplo: 53cUr17y
Se necesita si la administración de seguridad está habilitada en el daemon de Data Mover. No es un parámetro válido si también se especifica -security_password_encrypted.
security_password_encrypted
[Opcional] Contraseña cifrada del superusuario.
Ejemplo: 052c7aabd14c7770141ac3c0137ab98ae0d3f0f7cddf588981206b010c0c1b2f
Se necesita si la administración de seguridad está habilitada en el daemon de Data Mover. No es un parámetro válido si también se especifica -security_password.
security_username
[Opcional] El ID de usuario de superusuario o el usuario autorizado de Viewpoint. El ID de usuario de superusuario es dmcl_admin y no se puede cambiar.
Se necesita si la administración de seguridad está habilitada en el Daemon de Data Mover.
task_id
[Opcional] ID de la tarea.
Ejemplo: 35
task_status_mode
[Opcional] Enumera todas las tareas con el modo de estado especificado.
Ejemplo: R
Modo de estado Descripción
A Todas las tareas activas (predeterminadas)
R Todas las tareas actualmente en ejecución
Q Todas las tareas actualmente en cola

Notas sobre el uso

  • Para detener las actualizaciones de la vista de tareas en el caso de que haya proporcionado un parámetro de frecuencia, pulse el carácter INTR del sistema (UNIX) o Ctrl + C (Windows).
  • El orden de los elementos XML es significativo y debe respetarse.

Ejemplo de archivo XML

Para el comando list_tasks, escriba datamove list_tasks -f parameters.xml.

El siguiente ejemplo muestra todas las tareas en cola para el trabajo job1 y el ID de tarea 123 del agente AgentA, y actualiza la vista cada cinco segundos.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmListTasks xmlns="http://schemas.teradata.com/dataMover/v2009" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.teradata.com/unity/DataMover.xsd">  <task_status_mode>Q</task_status_mode>
<job_name>job1</job_name>
<task_id>123</task_id>
<agent_name>AgentA</agent_name>
<frequency>5</frequency>
</dmListTasks> 
Dado que todos los parámetros son opcionales para el comando list_tasks, en el siguiente ejemplo se muestra un archivo XML mínimo.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmListTasks xmlns="http://schemas.teradata.com/dataMover/v2009" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.teradata.com/unity/DataMover.xsd">
</dmListTasks>

Ejemplo de resultado de comando

El siguiente ejemplo es un extracto de los resultados del comando list_tasks.


Ejemplo de salida del comando list_tasks.
Las columnas de salida incluyen lo siguiente según sea necesario o aplicable:
  • TASK
  • JOB NAME
  • PRIORITY
  • STATUS
  • AGENT
  • QUEUE
  • QUEUE ORDER
  • UTILITY
  • SRC SYSTEM
  • TARGET SYSTEM
  • USER POOL
  • LAST UPDATE

Seguridad

  • El comando list_tasks sigue las mismas comprobaciones de seguridad que el comando list_jobs.
  • Cuando no está activada la seguridad, un usuario de línea de comandos tiene permiso para ejecutar todos los comandos de Data Mover, entre los que se incluye el list_tasks command.
  • Cuando está activada la seguridad, un usuario necesita un permiso de nivel de trabajo (si la seguridad se establece en el nivel de trabajo) y un permiso de lectura de nivel de daemon para ejecutar el comando list_tasks.

Mensajes de error y otros resultados

Los siguientes mensajes de error hacen que la interfaz de línea de comandos de Data Mover se cierre con un código de error de -1:
Mensaje Descripción
- task_id: Error: [value] is not numeric. task_id se especifica pero no se puede convertir en un valor numérico.
- task_status_mode: Error: Invalid task_status_mode: [value]. See list_tasks help for the list of valid options. task_status_mode se especifica, pero con un valor incorrecto.
- frequency: [value] is not an integer, value specified has an invalid format or the value is greater than 2147483647. Se ha especificado una frecuencia, pero no se puede convertir a un número entero.
- frequency: [value] is not a positive integer. Se ha especificado una frecuencia, pero no como un número entero positivo.
Error: Active tasks found but not visible due to security restriction. User must have read permission on job to view job's tasks. La seguridad está activada y el usuario indicado no tiene permiso para ver las tareas.