User Guide > Designing and Executing Processes > Configuring Processes > Configuring Logging Options for a Process
Was this helpful?
Configuring Logging Options for a Process
Logging options are available on the Configuration tab and allow you to specify the default messages and error types that are detected when a process is run. These messages or errors are written into a log file. Changing the logging options affects a single process. This will not work if log file path contains a macro. To change the settings for all new processes, see Setting Logging Preferences.
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 configure logging options for a process:
1. In the process file, go to the Configuration tab.
2. Expand Logging Options and specify the following options:
Option
Description
Log file name
Click Browse and specify the log file name. By default, the log file name is same as the artifact name.
Note:  No log file is created if the specified log file path is incorrect or left blank.
Run options
Select one or more of the following:
Error and event logging ON/OFF - Allows you to turn ON and OFF the error and event logging in the log file.
Clear log file before run - Clears the contents of the log file before executing the process.
Break after first error - When selected the process execution will terminate on the occurrence of the first error.
Log final result to NT event log - Writes the final result to the NT event log.
Flush log to disk after each message - Sends the contents of the log file to a file on the disk after each message.
Note:  The Break after first error Logging Option on the Configuration tab overrides the Ignore Error option in the step level, hence when you set the Ignore Error option at step level, you should uncheck (disable) the Break after first error Logging option for the Ignore Error to be effective.
Error types to log
Select one or more of the following types of errors that must be logged in the log file:
Errors: Logs errors that can cause the process execution to stop if Break after first error is set.
Warnings: Logs messages about data truncation in a field, field name changes, loss of precision, or other issues.
Information Messages: Logs messages such as "Execution initialization...", "Execution successful", whether the process execution 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.
3. Click File > Save to save the changes.
Note:  This setting is specific to the process file and overrides the global settings specified in Setting Logging Preferences.
Note:  For a new process, the Logging Options displays the Log file name and Error types to log that was specified in Setting Logging Preferences.
Last modified date: 02/09/2024