Previous Topic: Managed Transfers (TOS)Next Topic: dtscli Command—Send Multiple Output Files (Managed)


dtscli Command—Create Transfers

The dtscli -transfer (or -t) command creates a transfer.

This following syntax is used for simple transfers:

dtscli -transfer "ipath=InitiatorMachine::SourceFile"
"rpath=Respondermachine::DestinationFile"
iuser=InitiatorUser::Password
ruser=ResponderUser::Password
Release 12.5.00

Example:

This example first creates the transfer (ID 270), places it in a transfer job (ID 271), and activates the transfer job.

dtscli -transfer "ipath=Gold::c:\dtstemp\file.src"
"rpath=Silver::c:\dtstemp\file.dest"
iuser=dts::dts 
ruser=dts::dts

Sample Output Messages

Transfer 270 created.
Transfer job 271 created.
Transfer job 271 activated.
Transfer job 271 state: STARTING
Transfer job 271 state: IN_PROGRESS

Note: Your transfer and job IDs may differ from those in this example.

Example:

The default behavior of dtscli -transfer is to immediately activate the transfer and delete it after it has successfully completed. This may not be the desired behavior.

The -mode parameter group lets you specify a mode of control: whether the transfers are executed immediately and, if they are, whether the underlying objects are deleted once the transfers are complete.

This example keeps a transfer after it has been activated.

dtscli -transfer "ipath=Gold::c:\dtstemp\file.src"
"rpath=Silver::c:\dtstemp\file.dest"
iuser=dts::dts 
ruser=dts::dts
-mode keep

Sample Output Messages

Transfer 292 created.
Transfer job 293 created.	<- Transfer job ID
Transfer job 293 activated.
Transfer job 293 state: STARTING
Transfer job 293 state: IN_PROGRESS

The output tells you the ID of the transfer and transfer job.

The transfer is created, activated, but not deleted. If you have the ADT Transfer Client installed, you can see the transfer and the transfer job that have been created.

Example:

This example creates a new transfer, but does not activate or add the transfer to a job.

dtscli -transfer "ipath=Gold::c:\dtstemp\file.src"
"rpath=Silver::c:\dtstemp\file.dest"
iuser=dts::dts 
ruser=dts::dts
-mode defer

Sample Output Messages

Transfer 291 created.

The output tells you the ID of the transfer that has been created.

The transfer is created but activation is deferred. Again, use the transfer client and view the transfer that has been created in “unassigned transfers”. You can also use dtscli to view the transfer:

dtscli -transfer method=status id=all

More information:

dtscli -transfer Parameter Group—Perform Managed Transfers