Previous Topic: dtscli -schedule Parameter Group—Manage SchedulesNext Topic: dtscli -agent Parameter Group—Perform Agent-to-Agent Transfers


dtscli -log Parameter Group—Specify Logging Level and Mode

The -log parameter group specifies whether transfers are to be activated synchronously or asynchronously, and what level of logging is required.

This syntax has the following 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: To specify that a message is written to the console each time 10 percent of the transfer completes, enter the following command:

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 the progress of the transfers should be monitored or not. 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. Consequently, 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 should 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