User Guide > Setting Preferences > Setting Execution Preferences > Setting Logging Preferences
Was this helpful?
Setting Logging Preferences
Logging preferences allows you to specify the default messages and error types that are detected when a map or process is run. These messages or errors are written into a log file. This preference will be applied to every new map and process.
To change the settings for a single map or process, see Configuring Logging Options for a Map and Configuring Logging Options for a Process. This will not work if log file path contains a macro.
You can use the command line options to override the settings specified on the Configuration tab when executing a map or process from the djengine command line. For more information, see Command Line Options.
To set logging preferences:
1. Go to Options > Preferences.
The Preferences dialog box is displayed.
2. In the left-pane, expand DataConnect and click Execution.
3. Click on the Logging Defaults tab and specify the following options:
Option
Description
Create unique log file name
Allows you to create log files with same name as the artifact name with the file extension as .log. This is applicable only for new artifacts.
Note:  If this option is selected, the file name specified in the Execution Log Location is ignored.
Write log to project folder
Creates log file in the project folder. This is applicable only for new artifacts.
If multiple artifacts have the same name, then the logs are included to the previous log file (that has the same name), if available unless the artifacts are in different projects.
Note:  If this option is selected, the path specified in the Execution Log Location is ignored.
Execution Log Location
Allows you to browse and select an existing log file or type a new log file name. The default log file name is DataConnect.log and the default location is: C:\Users\<username>\Actian\DataConnect\Logs\
Note:  If Create unique log file name or Write log to project folder is selected, then the file name and path specified in the Execution Log Location is ignored.
Note:  No log file is created if the log file path specified in Execution Log Location is incorrect or left blank.
Error Types
Allows you to select the types of error messages that must be included in the log file:
• Errors: Logs errors that may cause a map or process to stop.
• Warnings: Logs messages about data truncation in a field, field name changes, loss of precision, or other issues.
• Informative Messages: Logs messages such as "Execution initialization", "Execution successful", number of records converted, deleted, updated, or inserted, time to convert, and whether the transformation was stopped.
• Debug Messages: All messages generated as a result of a TraceOn action and some other messages are logged at this level. In this case, the record number, first five fields of each record, and all the events are recorded.
The messages are logged up to the selected log type including the previous log types in the order of precedence. For example, if Warnings is selected, then the log file includes both Errors and Warnings messages. Similarly, if Debug Messages is selected, then the log file includes Errors, Warnings, Informative Messages, and Debug Messages.
Note:  In case of v9 compatible artifacts, only the selected type of error message is included in the log file.
4. Click Apply to save the changes.
Last modified date: 02/01/2024