Log files settings
User's Manual Start Page
CodeTwo Exchange Rules creates text log files where information about all messages sent outside the organization and about actions taken on them by the program is saved.

The files have a CSV format (Comma Separated Values). There are field names in the first line and data of processed messages in the other lines. Specific data fields are separated with a | ("pipe") sign. The table below explains the meaning of specific fields.

Field name Description
Time Time when the message was processed.
EntryType Entry type, "Info" if the entry has informational meaning, "Error" - if an error occurred.
Subject Message subject.
Sender Message sender's SMTP address. If the sender is a member of local Active Directory, then this is his default SMTP address. If the message was submitted to Exchange by an external sender via SMTP protocol, then it is the SMTP address entered in the MAIL FROM command in the SMTP protocol.
RecipientCount Message recipients count.
Recipients Message recipients' SMTP addresses. If there is more than one recipient, this field might not contain all addresses (because of performance reasons). In that case three dots ("...") will appear at the end of this field.
MsgStatus Message status in the SMTP server. This field has a diagnostic meaning only.
RuleName Name of the rule applied to the message. If no rule was applied, the field has a "None" value.
Action Description of an action taken by CodeTwo Exchange Rules on the message.
Comment Additional description explaining why a specific action was taken on the message.


Log files are created by default in the program installation directory in the Logs subdirectory. A new log file is created every day. A new file is also created when the size of a previous one is 2 MB. The name of a log file contains the day the file refers to and a suffix identifying the log number on a specific day, for instance a file name:
2007.04.06_002.txt
means that the log file refers to April 6th, 2007 and it's the second log file created during that day. By default, the program keeps 5 last log files, the older ones are automatically removed.

Log files can be managed by choosing the Log files command in the Exchange Rules Admin program. The Log files settings dialog will be displayed (pic.1).

Log files settings management
Pic.1. Log files settings management.

If the Save information about all messages in the logs option is checked, information about all mail messages processed by Microsoft Exchange will be saved in the logs, that is about inbound, outbound messages and messages sent within the organization. This is the way to create a complete log with records about all messages sent via Exchange Server. If the option is not checked, only information about outbound messages - i.e. sent outside the organization - is saved in the log files. By default, the option is unchecked.

You can define the directory where the log files will be saved in the Save log files in the folder field. By default, it is a Logs subdirectory in the program installation directory.

If the Delete older log files if their number in the above folder is higher than option is checked, the program will automatically remove the oldest log files if the number of files exceeds the defined value. By default, the option is checked and the number of log files is set to 5.