Message Scan Options

Top  Previous  Next

AgGw000014

 

Alligate also provides uses with the mechanism to scan messages using regular expressions.

 

Enable Message Data Scan: Enables or disables this capability. It is enabled by default, however there may be situations where where a regular expression(s) you have created are giving unexpected results. This allows you to turn off this feature temporarily so you can debug your expressions.

 

An editor window is provided for this purpose of entering regular expressions.

 

Each line in the editor should be considered an individual test.

 

Comments are allowed and must be preceded with a # character.

 

The format for each line is as follows:

 

Test_Type  Test_Name  Penalty  Regex

 

Each item MUST be separated by a tab or semicolon and NO spaces.

 

Test_Type must be one of the following:

 

HEADER  -  tests the header only

BODY  -  tests the message bode only

ALL  - tests both the message header and message body

RAW  -  tests the entire un-decoded message

 

Test_Name is a user defined name (single word) that will show in log files if it fails.

 

Penalty is an integer number indicatint the penalty you want to assign. The penalty can also be a negative number for counter weighting purposes.

 

Regex is a valid regular expression.

 

This is stored in a plain TXT file in the root Alligate folder called AgScanFile.txt. This file can be modified or replaced on the fly if desired. It is reloaded automatically if the contents are changed and it is not necessary to restart any services.

 

warning

 

These tests should be used judiciously, especially on high volume servers. There is some overhead involved in scanning messages and users should be aware that heavy use of message scanning may cause some performance degradation. Also, users should try to avoid overly complicated regular expressions.