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: Create and Activate a Transfer

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: Create and Keep a Transfer in the TOS

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. (Making a note of the transfer job’s ID is useful.)

The transfer is created, activated, but not deleted. If you have the ADT Transfer Client installed, open your transfer client; you will be able to see the transfer and the transfer job that have been created.

Example: Create but Do Not Activate a Transfer

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

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. Make a note of the transfer’s ID, as it is used in another example.

The transfer is created but activation is deferred. Again, use the transfer client and view the transfer that has been created. You will find it 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