用途
任务是特定于实用程序的,由 Data Mover 代理执行。从高级别的角度来看,此视图可确定使用了 Data Mover 任务相关资源(如代理任务插槽、加载插槽等)的任务。从作业级别的角度来看,此视图可确定阻止特定作业的工作和执行之前的延迟时长。
参数
请参阅参数顺序。
- agent_name
- [可选] 代理名称。
- dm.rest.endpoint
- [可选] 输入 Data Mover REST 服务器 URL 以覆盖 commandline.properties 文件中指定的缺省值,以便在运行时连接到不同的 REST 服务器(进而连接到不同的守护程序)。
- frequency
- [可选] 以秒为单位表示的状态更新频率。
- job_name
- 示例: [可选] 监控与此作业相关的任务。
- security_password
- [可选] 超级用户或授权 Viewpoint 用户的密码。
- security_password_encrypted
- [可选] 超级用户的加密密码。
- security_username
- [可选] 超级用户或授权 Viewpoint 用户的用户 ID。超级用户的用户 ID 为 dmcl_admin 且不能更改。
- task_id
- [可选] 任务 ID。
- task_status_mode
- [可选] 列出具有指定状态模式的所有任务。
用法说明
- 如果要在已指定频率参数的情况下停止任务视图更新,请按系统 INTR 字符 (UNIX) 或 Ctrl+C (Windows)。
- XML 元素的顺序很重要,必须遵守。
XML 文件示例
对于 list_tasks 命令,请键入 datamove list_tasks -f parameters.xml。
以下示例显示了代理 AgentA 上的作业 job1 的所有排队任务和任务 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>job1</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 命令输出的一段摘录。
输出列包括以下几项(如果需要或适用):
- 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. | 已启用安全设置,但是提供的用户没有查看任务的权限。 |