Commands › dtscli Command—Manage Data Transfers

dtscli Command—Manage Data Transfers

The dtscli command manages data transfers, transfer jobs, and schedules. The DTSCLI collects related arguments together in groups because of the large number of command line arguments. Arguments are specified left-to-right on the command line and are interpreted in terms of the most recently specified argument group.

This command has the following format:

dtscli [-tos params]

[-sos params]
[-transfer params]
[-job params]
[-schedule params]
[-mode mode]
[-log params]
[-c comments-string]
[@filename]

dtscli [-agent params]

[-log params]
[-c comments-string]
[@filename]

dtscli -help [group [argument]]
dtscli -version

-tos

(Optional) Specifies the location of the Transfer Object Server (TOS) and any user credentials needed to connect to it.

-sos

(Optional) Specifies the location of the Schedule Object Server (SOS) and any user credentials needed to connect to it.

-transfer

(Optional) Creates, deletes, and retrieves the status of the transfer objects.

-job

(Optional) Creates, deletes, and invokes other methods on transfer job objects.

-schedule

(Optional) Creates, deletes, and invokes other methods on schedule objects.

-mode

(Optional) Specifies the object lifetime mode, controlling whether transfers created by the DTSCLI are activated after creation and, if so, whether they are deleted after the transfer completes.

-log

(Optional) Specifies whether transfers are to be activated synchronously or asynchronously, and what level of logging is required.

-c

(Optional) Specifies a comment string.

Default: None

@filename

(Optional) Specifies the full path name of the command file to be read and used as input.

-agent

(Optional) Performs agent-to-agent transfers.

-help

Displays help for the dtscli command line interface.

-version

Displays version information for the dtscli command line interface.

Example: Create Basic Transfer Operation

The following example creates a transfer object, a transfer job object, adds the transfer to the transfer job, executes the transfer job, and deletes the transfer object and the transfer job object. The ipath and rpath arguments specify the full path of the file on the initiator and responder, respectively. This example assumes the TOS is on the local machine, and both the TOS and the two DTS agents are operating in quiet mode.

dtscli -transfer ipath=jupiter::c:\data\03105.dat

rpath=neptune::c:\data\jupiter\03105.dat