HOW TO: Log Data Transformation Services Package Execution to a Text File (316043)

SUMMARY

SQL Server can log information about package execution and the detailed step level execution in a package to a text file. You can use the text log file to troubleshoot both package level and step level errors. This article describes how you enable logging to a text file.

back to the top

SQL Server 2000 Steps to Enable Logging to a Text File

Open a package in the Data Transformation Services (DTS) Designer in Enterprise Manager.
On Package menu, click Properties.
In the Properties dialog box, click the Logging tab.
In the Error Handling section, type a file name in the Error file text box. For example, C:\Errordts.log. You can also click the Browse button and browse to the folder in which you want to write the log file. You can also browse to an existing error log file and have the error log append to that file.
Select the Fail package on first error option if you want the whole package to fail if any of the steps fail for the first time.

back to the top

SQL Server 7.0 Steps to Enable Logging to a Text File

Open a package in the DTS Designer in Enterprise Manager.
On the Package menu, click Properties.
In the Properties dialog box, click the Global tab.
In the Error Handling section, type a file name in the Error file text box. For example, C:\Errordts.log. You can also click the Browse button and browse to the folder in which you want to write the log file. You can also browse to an existing error log file and have the error log append to that file.
Select the Fail package on first error option if you want the whole package to fail if any of the steps fail for the first time.

back to the top

Troubleshooting

The path specified for the error log file must exist and the proper permissions to the folder, the drive, and path must be set to make sure that the error log file is written. The permissions you must have are dependent on where the DTS package executes. For additional information about permissions related to DTS packages, click the article number below to view the article in the Microsoft Knowledge Base:

269074 INF: How to Run a DTS Package as a Scheduled Job

The error log file is appended to each time the DTS package runs. The error file will include each step even if the step is not run. This is different from logging to SQL Server, which does not insert a row into the sysdtssteplog system table if the step does not run. You can use the error log to learn which step stopped responding and why it stopped responding.

back to the top