Managed Transfers (TOS) › dtscli Command—Send Multiple Output Files (Managed)

dtscli Command—Send Multiple Output Files (Managed)

The dtscli -transfer (or -t) command can be used to send multiple output files using a managed transfer. Enter the -transfer operand once for each input and output file separated by a space. Using a single dtscli command, you can specify a maximum of 16 transfers.

Example:

This example specifies only one output file.

dtscli -t "ipath=steve::c:\misc\secrets.doc" 

"rpath=katie::c:\misc\secrets.doc"

Important! When creating multiple managed transfers, specify the -tos, -sos, -job, and -schedule operands one time only, no matter how many transfers you create. However, specify the -transfer operand and all of its parameters (such as ipath=, rpath=, direction=, and so on) once for each transfer (each -transfer expression).

Examples: Managed Transfers for Every Supported Protocol Except CPI-C

After you create a new transfer, dtscli does not carry over values from the previous transfer. The following example specifies three transfers: the first transfer uses delimiter conversion (delimiter_conversion=y), but the other two transfers do not specify this parameter, so they use the default (delimiter_conversion=n). This example is valid for Windows, and it sends the same input file to three different computers. A remote Transfer Object Server is used for all transfers.

dtscli -tos host=wsiwig

-t "ipath=steve::c:\misc\secrets.doc" "rpath=margaret::c:\misc\secrets.doc" delimiter_conversion=y
-t "ipath=steve::c:\misc\secrets.doc" "rpath=katie::c:\misc\secrets.doc" 
-t "ipath=steve::c:\misc\secrets.doc" "rpath=roshni::c:\misc\secrets.doc" ...

In the example above, the same input file (with the same path name) is sent to each receiving computer. If required, you could send two or more different input files, change the path name of the output files, or both.

This example sends three different input files, and a new file name is specified for each output file.

dtscli -t "ipath=steve::c:\receipts\monday.doc" "rpath=margaret::c:\monday\mon_fs.doc" 

-t "ipath=steve::c:\receipts\tuesday.doc" "rpath=margaret::c:\tuesday\tues_fs.doc" 
-t "ipath=steve::c:\receipts\wednesday.doc" "rpath=margaret::c:\wednesday\wed_fs.doc" ... 

Note: If any computer in the transfer has its security mode set to "fail," ensure that you specify the correct user names and passwords for all receiving computers. Alternatively, make sure that the security mode is quiet or warn on any receiving computer for which you have not specified a valid user ID and password. Otherwise, the security features of the DTS agent on the receiving computer cause the transfer to that computer to fail.

More information:

Managed Transfers