list_agents (Teradata Database) - Teradata Data Mover

Purpose

The list_agents command lists the Data Mover agents connected to the Data Mover daemon.

Syntax

See http://schemas.teradata.com/unity/DataMover.xsd.

Parameters

See Parameter Order.

agent_names

[Optional] Lists the connectivity of the agents that are specified. When specifying the agents, use commas to separate the agents. Do not use spaces.

AgentA,AgentB

broker.port

[Optional] You may enter a broker port to overwrite the default value specified in the commandline.properties file in order to connect to a different ActiveMQ server (and therefore a different daemon) at runtime.

61616

broker.url

[Optional] You may enter a broker URL to overwrite the default value specified in the commandline.properties file in order to connect to a different ActiveMQ server (and therefore a different daemon) at runtime.

dm-server1

frequency

[Optional] Frequency for updating the status of the Data Mover agent in seconds.

5

If this parameter is specified, the status of the Data Mover agent is updated every frequency seconds. To stop the status updates, press the system INTR character (UNIX) or Ctrl+C (Windows). If the frequency parameter is not specified, the status is displayed only once and is not updated.

Usage Notes

If the agent_names parameter is not specified, the list_agents command lists all connected agents. If agent_names is used, only the connectivity of agents that are specified are listed.

XML File Example

For the list_agents command, type datamove list_agents -f parameters.xml.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<dmListAgents
 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">
  <agent_names>AgentA</agent_names>
</dmListAgents>