Previous Topic: Data Browser Agent Plugin Policy GroupNext Topic: Macro Policy Group


Data Transport Agent Plugin Policy Group

The Data Transport Agent plugin (DTA), which is an agent component, can run in either a "master" role or "slave" role. The Data Transport Agent Plugin policy group contains the following policies for the DTS agent and for any master and slave ports. You can modify policy parameter values by double-clicking a policy to display the Setting Properties dialog.

Agent auditing mode

Enables monitoring by the DTS agent, if True.

Default: True

Communication protocol: Open connection timeout

Defines a connection-specific parameter. Change only if directed by Technical Support.

Limits: 1–1000

Default: 10

Communication protocol: Receive initialization message timeout

Defines a connection-specific parameter. Change only if directed by Technical Support.

Limits: 1–1000

Default: 30

Communication protocol: Receive Timeout

Defines a connection-specific parameter. Change only if directed by Technical Support.

Limits: 1–1000

Default: 80

Communication protocol: Send initialization message timeout

Defines a connection-specific parameter. Change only if directed by Technical Support.

Limits: 1–1000

Default: 50

Communication protocol: Timeout

Defines a connection-specific parameter. Change only if directed by Technical Support.

Limits: 1–1000

Default: 60

Concurrency

Specifies the maximum number of slave processes that can run concurrently. You can set the concurrency value higher to increase the maximum data throughput for data transfers across your network, or set it lower to decrease the maximum data throughput. The optimal level varies for each computer, depending on the overall resources and load.

Note: Try to determine the best value for your system. A value that is too high or too low may contribute to system overload on individual computers or data traffic jams or bottlenecks on the network.

Limits: 1–10000

Default: 10

Concurrency to reserve for responders

Specifies the minimum portion of the concurrency value that is reserved exclusively for agents acting as responders.

Limits: 0–10000

Default: 1

Discreet mode

Enables discreet mode for the agent on the specified computer, if True. Transfers performed in discreet mode are called discreet transfers. Discreet transfers are sent and received in the background, using minimal bandwidth, when the sending and receiving computers are not heavily loaded. Based on the load, the Data Transport Agent determines when to send the transfer and calculates the optimal transfer rate, so that the discreet transfer has minimal impact on the computer’s performance and the user’s productivity. If False, discreet mode is disabled and the agent performs the transfer as quickly as possible.

Default: False

Enable ADT trusted security

Configures the DTS agent for use with DTS trusted security for Advantage Data Transport, if True.

Default: False

Fanout keep alive message timeout

Specifies the timeout period in seconds of the keep alive messages sent between the initiator and responder agents that are involved in a fanout.

Limits: 1–1000

Default: 5

Forced shutdown

Specifies that the agent slave processes not perform any transfers while the master shuts down idle slaves, if True.

Default: True

Heartbeat interval

Specifies the regularity of heartbeat status messages from a slave to a master. Slave processes send status messages to the master process at regular intervals—in seconds—to signal that they are functioning correctly. These messages are known as heartbeats. For the master, this value specifies how often to expect heartbeat status messages from slaves; and for slaves, it specifies how often to send heartbeat status messages.

Limits: 60–1200

Default: 60

Heartbeat timeout

Specifies the number of seconds for a master process to wait for a heartbeat status message from a slave process before the master process discards the slave process and assumes failure.

Note: This value should be at least three times the value for the Heartbeat interval policy.

Limits: 180–3600

Default: 255

Hop file lifetime

Specifies the time in minutes that hop files remain in the agent's staging directory.

Limits: 60–20160

Default: 60

Legacy messaging support

Enables scanning for incoming transfer requests on the legacy CA Message Queuing (CAM) queues, if True. This is required for compatibility with earlier versions of DTS (r1, r2, and r3).

Default: True

Master protocol parameters

Specifies the protocol parameters used by the master processes.

Default: RPORT=<8222> UDP_RPORT=<8223> BCAST_RPORT=<8224> MCAST_RPORT=<8225> SPX_RPORT=<8226> CPIC_LUNAME_LISTEN=<DTA1>

Security mode

Determines whether incoming transfer requests must be authenticated. Responses to security violations are dependent on the current security mode. Valid values are as follows:

quiet

Disables security checking.

warn

Enables security checking. If an invalid request is detected, the operation is permitted to continue. However, the violation is recorded in the log file to indicate the occurrence.

fail

Enables security checking. If an invalid request is detected, the operation is immediately aborted. When fail mode is enabled, users are required to enter a valid user name and password before they are able to display or set the runtime parameters for any of the DTS computers.

Default: fail

Sequential connect

Specifies that the agent master processes respond sequentially to incoming responder connections, if True.

Default: True

Slave lifetime timeout

Specifies the length of time in seconds that an inactive slave process idles before shutting down.

Limits: 300–3600

Default: 1800

Slave protocol parameters

Specifies the protocol parameters used by the slave processes.

Default: RPORT=<ANY> UDP_RPORT=<ANY> BCAST_RPORT=<ANY> MCAST_RPORT=<ANY> SPX_RPORT=<ANY> CPIC_LUNAME_LISTEN=<DTA1>

Staging area quota

Specifies the maximum size in megabytes (MB) of the staging directory on the specified agent. The staging directory stores the staging files of transfers that are in progress or that have failed or aborted.

DTS checks the size of the staging directory at regular intervals, according to the value set for the Staging area quota check interval policy. If the size of the staging directory is greater than the Staging area quota value, then DTS deletes the oldest inactive staging file. DTS continues to delete the next oldest staging files until the size of the staging directory is less than the Staging area quota value.

Limits: 50–102400

Default: 1024

Staging area quota check interval

Specifies the interval in minutes when Data Transport Service checks the size of the staging directory. If you specify 0, DTS never checks the size of the staging directory.

Limits: 0–525600

Default: 0

Staging directory location

Identifies the directory where staging files are stored. Staging files are temporary copies of the data being transferred. Once the data transfer is complete, these temporary staging files are discarded. If no value is set, then the default location is in a directory named staging, which is directly beneath the DTS installation directory.

Default: empty

Staging file lifetime

Specifies the number of hours that a failed or aborted transfer must be inactive before its staging files are deleted. DTS automatically deletes the staging files of successful transfers. However, it does not automatically delete the staging files of failed or aborted transfers. Instead, DTS uses the Staging file lifetime policy to determine if and when to delete the staging files of such transfers. The staging files of failed or aborted transfers are deleted when the specified number of hours has passed after the transfer was activated.

If you specify 0, Data Transport Service never deletes the staging files of failed or aborted transfers.

Limits: 0–8760

Default: 168

Supported protocols

Specifies the types of protocol supported by the agent. Valid values are as follows: TCP, LTCP, HTTP, SPX, UDP, MCAST, BCAST, PPP, and CPIC.

Note: DTS does not support the latest version of PPP communication protocol, PPPv6.

Note: All protocols are not supported on all operating systems.

Default: TCP,LTCP,HTTP,UDP,MCAST,BCAST,PPP

Back to Top