Agent-to-Agent Transfers › dtscli Command—Create Multiple Point-to-Point Transfers

dtscli Command—Create Multiple Point-to-Point Transfers

The dtscli -agent (or -a) command can be used to create multiple point-to-point transfers. The same input file can be transferred to multiple output locations by using the rpath and transfer_mode parameters.

Valid values for the transfer_mode parameter are as follows:

p2p

Specifies a point-to-point transfer.

PPP

Specifies Point to Point Protocol (PPP) mode. Valid only for point-to-point transfers over standard telephone lines, ISDN, and other high-speed connections.

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

f (or fanout)

Specifies a fanout transfer.

bcast

Specifies an IPv4 broadcast point transfer.

mcast

Specifies an IPv4 or IPv6 multicast transfer.

Default: p2p

Example: Transfer in Point-to-Point Mode

This example performs two point-to-point transfers: first, the transfer between Gold and Silver, and after that has finished, the transfer between Gold and Bronze takes place.

dtscli -agent "ipath=Gold::c:\dtstemp\file.src"

"rpath=Silver::c:\dtstemp\file.dest"
"rpath=Bronze::c:\dtstemp\file.dest"

Example: Transfer in Fanout Mode

Fanout transfers are those in which data is sent to multiple responding computers using a direct point-to-point communications protocol. Data is read once and then sent multiple times, once to each of the target responders.

This example sets the transfer method to fanout mode for the earlier point-to-point transfer example:

dtscli -agent "ipath=Gold::c:\dtstemp\file.src"

"rpath=Silver::c:\dtstemp\file.dest"
"rpath=Bronze::c:\dtstemp\file.dest"
transfer_mode=fanout

Example: Transfer as a Broadcast

This example sets the transfer method to broadcast (bcast). Broadcasts require a broadcast address.

dtscli -agent "ipath=Gold::c:\dtstemp\file.src"

"rpath=Silver::c:\dtstemp\file.dest"
"rpath=Bronze::c:\dtstemp\file.dest"
transfer_mode=bcast
broadcast_address=your_broadcast_address

Example: Transfer as a Multicast

This example sets the transfer method to multicast (mcast). Multicasts are similar to broadcasts in that you need a multicast address:

dtscli -agent "ipath=Gold::c:\dtstemp\file.src"

"rpath=Silver::c:\dtstemp\file.dest"
"rpath=Bronze::c:\dtstemp\file.dest"
transfer_mode=bcast
multicast_address=your_multicast_address

Note: For instructions for calculating broadcast and multicast addresses, see the Data Transport Service Administration Guide.