dtscli Command—Manage Data Transfers › dtscli -log Parameter Group—Specify Logging Level and Mode

dtscli -log Parameter Group—Specify Logging Level and Mode

The -log parameter group specifies whether to activate transfers synchronously or asynchronously, and the level of logging required.

Syntax format:

dtscli -log interval=interval level=level mode=append|replace monitor=y|n path=path

Note: The -log operand can be abbreviated as -l.

interval=interval

Specifies the percentage interval at which progress messages are logged when monitoring a transfer.

Default: 10

Example: Specify that a message is written to the console each time 10 percent of the transfer completes:

dtscli ... -l interval=10 

After the transfer is activated, the cumulative system response after the transfer is 30 percent complete appears:

transfer 457 activated ...

10% complete ...
20% complete ...
30% complete ...

level=level

Specifies the logging level. Valid values are as follows:

0 = Silent

1 = Minimum

Specifies that object creation and deletion messages are not logged at this level.

2 = Medium

3 = Maximum

Default: 1

mode=append|replace

Specifies the logging mode. Valid values are as follows:

append

Appends logging messages to the existing file.

replace

Replaces the existing log file.

Default: append

monitor=y|n

Specifies whether to monitor the progress of the transfers. Valid values are y (yes) and n (no). If y, a transfer is monitored and the progress of the transfer is written to the console. No commands can be entered on the command line until the transfer completes or fails.

Default: y

path=path

Specifies the location of the file to which log messages are be written. If you enter a path name, enclose it in quotation marks, for example:

dtscli -l path="c:\logs\080100.log"

If you enter the standard output path (stdout), the output is displayed on the console unless you have specified another location in your shell.

Default: stdout