16.20 - list_tasks - Teradata Data Mover

Teradata® Data Mover 用户指南

Product
Teradata Data Mover
Release Number
16.20
Published
2021 年 11 月
Content Type
用户指南
Publication ID
B035-4101-107K-CHS
Language
中文 (简体)

用途

任务是特定于实用程序的,由 Data Mover 代理执行。从高级别的角度来看,此视图可确定使用了 Data Mover 任务相关资源(如代理任务插槽、加载插槽等)的任务。从作业级别的角度来看,此视图可确定阻止特定作业的工作和执行之前的延迟时长。

参数

请参阅参数顺序

agent_name
[可选] 代理名称。
AgentA
broker.port
[可选] 用于覆盖 commandline.properties 文件中指定的缺省值的代理程序端口,以便在运行时连接到不同的 ActiveMQ 服务器(进而可连接到不同的守护程序)。
示例: 61616
broker.url
[可选] 用于覆盖 commandline.properties 文件中指定的缺省值的代理程序 URL,以便在运行时连接到不同的 ActiveMQ 服务器(进而可连接到不同的守护程序)。
示例: dm-server1
frequency
[可选] 以秒为单位表示的状态更新频率。
示例: 5
job_name
示例: [可选] 监控与此作业相关的任务。
12315DFHJKS
security_password
[可选] 超级用户或授权 Viewpoint 用户的密码。
示例: 53cUr17y
如果 Data Mover 守护程序上已启用安全管理功能,则必须提供此参数。如果同时指定了 -security_password_encrypted,则此参数无效。
security_password_encrypted
[可选] 超级用户的加密密码。
示例: 052c7aabd14c7770141ac3c0137ab98ae0d3f0f7cddf588981206b010c0c1b2f
如果 Data Mover 守护程序上已启用安全管理功能,则必须提供此参数。如果同时指定了 -security_password,则此参数无效。
security_username
[可选] 超级用户或授权 Viewpoint 用户的用户 ID。超级用户的用户 ID 为 dmcl_admin 且不能更改。
如果 Data Mover 守护程序上已启用安全管理功能,则必须提供此参数。
task_id
[可选] 任务 ID。
示例: 35
task_status_mode
[可选] 列出具有指定状态模式的所有任务。
示例: R
状态模式 说明
A 所有活动任务(缺省)
R 当前正在运行的所有任务
Q 当前已排队的所有任务

用法说明

  • 如果要在已指定频率参数的情况下停止任务视图更新,请按系统 INTR 字符 (UNIX) 或 Ctrl+C (Windows)。
  • XML 元素的顺序很重要,必须遵守。

XML 文件示例

对于 list_tasks 命令,请键入 datamove list_tasks -f parameters.xml

以下示例显示了代理 AgentA 上的作业 arcJob 的所有排队任务和任务 ID 123,并且每五秒更新一次视图。
<?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>arcJob</job_name>
<task_id>123</task_id>
<agent_name>AgentA</agent_name>
<frequency>5</frequency>
</dmListTasks> 
由于所有参数都是 list_tasks 命令的选项,因此以下示例显示了最小的 XML 文件。
<?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>

命令输出示例

以下示例是 list_tasks 命令输出的一段摘录。


list_tasks 命令的示例输出。
输出列包括以下几项(如果需要或适用):
  • TASK
  • JOB NAME
  • PRIORITY
  • STATUS
  • AGENT
  • QUEUE
  • QUEUE ORDER
  • UTILITY
  • SRC SYSTEM
  • TARGET SYSTEM
  • USER POOL
  • LAST UPDATE

安全性

  • list_tasks 命令遵循与 list_jobs 命令相同的安全检查。
  • 在未启用安全性的情况下,命令行用户有权运行所有 Data Mover 命令,其中包括 list_tasks command
  • 在启用了安全性的情况下,用户需要作业级别的权限(如果安全性设置为作业级别)和守护程序级别的读取权限来运行 list_tasks 命令。

错误消息和其他输出

以下错误消息会导致 Data Mover 命令行界面退出并显示故障代码 -1
消息 说明
- task_id: Error: [value] is not numeric. task_id 已指定,但不能转换为数字。
- task_status_mode: Error: Invalid task_status_mode: [value]. See list_tasks help for the list of valid options. task_status_mode 已指定,但值不正确。
- frequency: [value] is not an integer, value specified has an invalid format or the value is greater than 2147483647. 频率已指定,但不能转换为整数。
- frequency: [value] is not a positive integer. 频率已指定,但不是正整数。
Error: Active tasks found but not visible due to security restriction. User must have read permission on job to view job's tasks. 已启用安全设置,但是提供的用户没有查看任务的权限。