|
|
MailBounce Preferences File: Advanced Settings
Current Release: v6.0, May 2003
This file details the "advanced" settings in the MailBounce Preferences file. Refer to the main Preferences documentation file for formatting requirements and other general information on the Preferences file.
Note that some of the advanced settings described in this document are rather arcane. Anyone who is new to MailBounce is urged to leave many of the defaults in place. Refer to the Preferences_Intro file if you are new to MailBounce.
Any settings that are not described in this file are italicized and linked to the appropriate locations in the Preferences_Expert file.
preferences version = '2.4'
This provides important information for MailBounce; please do not modify this line.
name = 'Your Name Here'
organization = 'Your Organization Name Goes Here'
machine = 'Fill in Machine Type and Speed'
These are self explanatory, and are free-form; fill in whatever you like. For "machine," I recommend inserting the type of computer you are using; filling in this field with a proper description (such as 'PowerMac 8500' or 'Sun Blade 280R') can provide useful information to Smart Mail Solutions, Inc., should you ever need to contact us for assistance.
registration key = '<save this for later>'
This is the field that you will have to fill in when you register MailBounce. Note, by the way, that this information is not actually USED by the freeware version, but since both versions use the same preferences file, it is important to leave these lines (and their contents) in place. Plus, you'll be all ready if you decide to upgrade to the full release. :-)
use trigger file = 'NO'
trigger file name = 'mailbounce_trigger_file.txt'
delete trigger file = 'NO'
These settings allow you to enable or disable the "trigger file." This file is used to control the execution of MailBounce, as follows: If the trigger file is present and is not empty (i.e., the file contains at least one character), then MailBounce will execute normally. If the file is either empty or missing, then MailBounce will not run.
An example of the use of this file is to control processing on a mailing list that has a relatively low posting rate. You can set up a mailbox and subscribe it to the mailing list; then, if at least one message has posted to the list since the last time that MailBounce was run, the spool file for that mailbox will be non-empty, which will cause MailBounce to run normally. If no posts have occurred on the list, then the spool file will be either missing or empty (depending on the mail system used), which will prevent MailBounce from running. (In short, MailBounce will not run until the next time a message is posted to the list.)
In order to enable this option, you must configure the your settings as follows:
use trigger file = 'YES'
trigger file name = 'mailbounce_trigger_file.txt'
Of course, you may select any appropriate file name for the trigger file. You may also include paths to the file in the file name.
The last option is DELETE TRIGGER FILE:
delete trigger file = 'NO'
When set to 'YES', this option will cause your trigger file to be deleted if the file is present and is not empty. (That is, if MailBounce executes on that pass, then it will delete the trigger file. If the file is present but is empty, the MailBounce will not run, and the trigger file will not be deleted.)
bounce file name = '<bounce filename goes here>'
This is the name of the file (including path to the file, if necessary) in which you have saved your bounces.
NOTE: Since a path can be specified with any file name, the statement "including path to the file, if necessary" will be implied in the descriptions for the rest of the file names.
ALSO NOTE: You must ensure that the file names you select are valid file names for your platform. For example, Macintosh filenames cannot exceed 31 characters (not including the path specification, if any).
bounce file format = 'TEXT'
This setting allows you to specify the file format for your bounce file. For example, if your mail client is "Outlook Express," and you are saving your bounces in a particular Outlook Express mail folder, then you no longer need to "Save" or "Save As" those messages to a separate text file in order to have MailBounce process them; instead, you can simply tell MailBounce that the file is an OE mail folder, and MailBounce will read in the folder directly. This also applies to Eudora mailboxes and LetterRip bounce digests. Valid settings are: 'OUTLOOK EXPRESS FOR MACINTOSH', 'OUTLOOK EXPRESS FOR WINDOWS' 'EUDORA', 'SENDMAIL', 'SPOOL', 'MAIL SPOOL', 'EIMS', and 'LETTERRIP'. (Note: 'SPOOL' and 'MAIL SPOOL' are equivalent and may be used interchangeably). If you are not sure of the format of your bounce file, then set this option to 'TEXT'. Refer to the File Format Options file for detailed information on how to configure this setting, plus info on Outlook Express compatibility.
bounce sensitivity = 'HIGH'
Up through v5.4.1, the MailBounce Recognition Engine performed speculative bounce recognition, in which it would selectively extract addresses that "appeared" to be responsible for the bounce message. The requirements for speculative recognition are very conservative, and there have been no reports of incorrect subscriber addresses being extracted as a result of speculative bounce recognition. However, in order to accommodate environments that are not conducive to speculative address extraction, the BOUNCE SENSITIVITY feature has been added.
There are currently two settings available for this feature:
HIGH: The HIGH setting enables speculative address extraction, and thus provides the same bounce-recognition performance for which MailBounce is renowned. This is the default setting.
LOW: In the LOW setting, MailBounce will not perform speculative address extraction. This will slightly degrade the bounce-recognition performance, but might be appropriate for sites that desire to be extra conservative in their bounce processing.
For backward compatibility, this feature will default to the 'HIGH' setting when MailBounce updates your Preferences file.
delete bounce file when finished = 'NO'
If you would like MailBounce to delete your bounce file when it finishes processing the file, then set this option to 'YES'. NOTE: Deleting the bounce file will cause the entire file and its contents to be removed. Do not select this option unless you specifically do not intend to keep a copy of the bounce file on hand.
use verp = 'NO'
verp preamble = 'verp-preamble-string-'
verp address encoding string = '#'
use custom header = 'NO'
custom header = 'X-Custom-Header:'
process multiple bounce files = 'NO'
process multiple subscriber lists = 'NO'
multi-list configuration file name = '<multi-list licenses only>'
write unrecognized bounces to file = 'NO'
If you want MailBounce to export all unrecognized bounces to a separate file, you should set this switch to 'YES'. Note that MailBounce can export bounces ONLY if your bounce file(s) is in a valid "mail spool" format. (Pro version only)
unrecognized bounces file name = 'unrecognized_bounces.txt'
If you are exporting bounces, this is the name of the file in which MailBounce will put the unrecognized bounces. (Pro version only)
use autoresponder rejection file = 'NO'
autoresponder rejection file name = 'mailbounce_AR_file.txt'
scratch file name = 'mailbounce_scratch_file.txt'
MailBounce uses the scratch file as a temporary file for temporary storage, e.g., if you are exporting bounces, or when rolling over the tracking files. (Pro version only)
match bounce addresses to subscriber list = 'YES'
When set to YES, this instructs MailBounce to check all addresses against the subscribers file, and to remove those addresses that either exactly match or fuzzy match subscriber addresses in the file. The following option selects the sensitivity level for the fuzzy matcher ...
fuzzy matching sensitivity = 'LOW'
This setting selects the sensitivity level for the fuzzy matcher. Starting with v5.4, the fuzzy matcher is now significantly smarter, and can match a much broader range of addresses. In addition, the fuzzy matcher's "sensitivity level" is user selectable, allowing you to choose the maximum "fuzziness sensitivity" at which addresses will be matched. Of course, as you increase sensitivity, you also increase the chance of incorrect matches ("false positives") -- so be sure to select a fuzziness level that you are comfortable with. The valid fuzziness sensitivity levels are:
HIGH -- Maximum fuzziness, will match the widest range of addresses. Highest risk of false positives.
MEDIUM -- Moderate fuzziness; this is a good "compromise" setting, since the risk of error is minimal, but it still matches a wide range of address formats.
LOW -- This is the most conservative fuzzy-matching setting, and is basically the same level of fuzziness that MailBounce has used up through v5.3. If you were comfortable with that level of performance, and want to stay with it, then use this setting.
OFF -- Turns off fuzzy matching entirely. Not recommended in most situations, since the 'LOW' setting has demonstrated excellent performance since its initial developmental testing and deployment in 1996.
reject unmatched addresses = 'YES'
When set to YES, this option instructs MailBounce to place into the server file ONLY the addresses that are matched to addresses the subscriber list during the address-matching phase. If set to NO, MailBounce will still attempt to match (and fuzzy match) addresses, but will write ALL defunct addresses to the server and BCC files, regardless of whether they were matched in the subscriber list.
subscriber list file name = '<subscriber list filename goes here>'
This is the name of the file in which you have saved the list of subscribers for your mailing list.
delete subscriber list when finished = 'NO'
If you would like MailBounce to delete the file containing your subscriber list when it has finished processing the list, then set this option to 'YES'. WARNING: Deleting the subscriber list will cause the entire file and its contents to be erased from the disk. Do not select this option unless the version of the subscriber list that MailBounce is processing is an "extra" copy that does not need to be retained.
subscriber list file format = 'TEXT'
This setting allows you to specify the format for the file that contains your subscriber list. For example, if your mail client is "Outlook Express," and you are saving your bounces in a particular Outlook Express mail folder, then you no longer need to "Save" or "Save As" those messages to a separate text file in order to have MailBounce process them; instead, you can simply tell MailBounce that the file is an OE mail folder, and MailBounce will read in the folder directly. This also applies to Eudora mailboxes and LetterRip bounce digests. Valid settings are: 'OUTLOOK EXPRESS FOR MACINTOSH', 'OUTLOOK EXPRESS FOR WINDOWS' 'EUDORA', 'SENDMAIL', 'SPOOL', 'MAIL SPOOL', and 'EIMS'. (Note: 'SPOOL' and 'MAIL SPOOL' are equivalent and may be used interchangeably). If you are not sure of the format of your bounce file, then set this option to 'TEXT'. Refer to the File Format Options file for detailed information on how to configure this setting, plus information on Outlook Express compatibility.
formatted subscriber list = 'YES'
If your subscriber list is properly formatted for your list server, then leave this option set to YES. If, however, you are bringing your subscriber list over from a different server, or an older version of the same server, and it is thus no longer in the "expected" format for this server, then set this option to NO. In this case, MailBounce will make no assumptions about the location of the subscribers' addresses on each line, and will do its best to find each address. (This is a slower process, so leave the option set to 'YES' if your file is in the expected format.)
update subscriber list directly = 'NO'
If you want MailBounce to update your subscriber list for you -- that is, remove defunct addresses from the file, and insert redirected addresses into the file -- then set this option to YES. Note that MailBounce will make a backup copy of your subscriber list before modifying it. (Pro version only)
subscriber list backup file name = 'Subscriber List Backup File'
If you opt to have MailBounce update your subscriber file for you, then this is the file where MailBounce will make a backup copy of your list for you. (Pro version only)
server file name = 'MailBounce Server File'
This is arguably your most important output file; it contains all of the "unsub" or "delete" commands for all of the defunct addresses that MailBounce found during the run. Once MailBounce finishes processing, you must e-mail this file to you list server in order to have the defunct addresses removed from your mailing list.
redirects file name = 'Redirected Addresses'
If MailBounce requires a secondary file for SUBSCRIBE actions (redirected addresses, for example), they will be placed in this file.
formatted server file = 'YES'
When set to YES, this option will generate a server file formatted for whatever supported list server you selected in the "list server type" prefs setting (below). When set to NO, the server file will be written as just a series of addresses, one address per line -- this is similar in behavior to entering 'MANUAL' for the "list server type" setting. The difference, however, is that setting this option to 'NO' allows you to provide the proper list server in the "list server type" setting -- which means that your subscriber file will still be parsed correctly for that list server type, while instructing MailBounce to generate an unformatted, server-independent output file. (This is useful for people who do not -- or cannot -- administer their mailing lists remotely.)
separate fuzzy files = 'NO'
When set to 'YES', MailBounce will place all fuzzy-matched addresses in separate files -- that is, it will generate "server fuzzy", "secondary server fuzzy", and "BCC fuzzy" files. (The names of those files are selected below.) When set to NO, MailBounce will place all of the addresses (exact matches and fuzzy matches) into the standard server and BCC files. (Pro version only)
server fuzzy file name = 'MailBounce Server Fuzzy File'
redirects fuzzy file name = 'Redirected Fuzzy Addresses'
BCC fuzzy file name = 'MailBounce BCC Fuzzy File'
Same as the files discussed above (server file name, redirects file name, and BCC file name), except that these files contain just the fuzzy-matched addresses. (Pro version only) The "BCC fuzzy file" also requires that you select the "BCC file" option, below.
BCC file = 'YES'
When set to 'YES', this option instructs MailBounce to write BCC files (file names are selected above). When set to 'NO', MailBounce will not write the files, regardless of whether you have selected names for thm.
BCC file name = 'MailBounce BCC File'
This file contains a comma-delimited list of all the defunct addresses found during the current processing run. The BCC file is generated in a format suitable for placement on the BCC line of an e-mail "form letter," informing subscribers that they have been removed from the mailing list because e-mail to their addresses has been bouncing. (Refer to the MB_Description file for a more complete discussion of the BCC file.)
process redirects = 'YES'
If MailBounce detects a redirect in your bounce file, it will extract both the old address and the new one, and will "redirect" the address -- i.e., it will unsubscribe the old address, and subscribe the new one. Note that the subscribe commands are placed into the "secondary server file." If you set this option to 'NO', MailBounce will display an informational message whenever it encounters a redirect, but will not process the redirect. (Pro version only)
separate server file for redirects = 'YES'
If this option is set to 'NO', then the server commands for subscribing the redirected addresses will be placed into the same server files as the the server commands for unsubscribing the defunct addresses. That is, the "secondary server file" will be combined with the primary "server file", resulting in one less file for you to send to the list server for processing. Of course, your list server must support this feature if you choose to use it; if your list server cannot process subscribes and unsubscribes in the same e-mail -- or if you're simply not sure whether or not your server supports it -- then you should set this option to 'YES', which will cause MailBounce to place all of the subscribes into a separate file (the name of the file is selected in the "redirects file name" setting). (Pro version only)
separate bcc file for redirects = 'NO'
If this option is set to 'NO', redirected addresses will be placed into the same BCC files as the defunct addresses. If, however, you would prefer to contact these subscribers separately, possibly using a different form letter, then setting this option to 'YES' will cause redirected addresses to be written to the "BCC redirects" files below. (Pro version only)
BCC redirects file name = 'BCC_redirects.txt'
BCC redirects fuzzy file name = 'BCC_redirects_fuzzy.txt'
These BCC files have the same format as the primary BCC file; addresses will be placed into this file only if they have been "redirected" from a different address. This option is valid only if both processing of redirects has been selected, separate files for redirects have been selected, and BCC files have been selected. (Pro version only)
use ignored file = 'NO'
If you have created an Ignored file, this setting informs MailBounce whether you want to activate the file. The Ignored file contains addresses that you want MailBounce to "ignore" when it processes your bounces. (Pro version only)
ignored file name = 'MailBounce Ignored'
This file contains the addresses that you want MailBounce to "ignore" when it processes your bounces. Refer to the Ignored file documentation for more information on this feature. (Pro version only)
use global remove file = 'NO'
If you have created an Global Remove file, this setting informs MailBounce whether you want to activate the file. The Global Remove file contains addresses that you want MailBounce always remove whenever they are found on your subscriber lists. Refer to the Global Remove File documentation for details on this feature. (Pro version only)
global remove file name = 'global_remove_file.txt'
diagnostics file = 'YES'
diagnostics file name = 'MailBounce Diagnostics'
summary file = 'NO'
summary file name = 'MailBounce Summary'
error log file = 'NO'
error log file name = 'MailBounce Error Log'
These are output files that summarize MailBounce's actions, and the "switches" that turn these files on and off. For example, if you want MailBounce to generate a summary file, then set the "summary file" option to 'YES'. Each file is described below:
Diagnostics file: Mimics the entire screen display, and provides detailed output of all actions taken by MailBounce. All hard- and soft-bouncing addresses found by MailBounce are displayed in this file, including the detailed operations of the bounce-tracking and address-matching stages. The Diagnostics file also includes a detailed listing of the Preferences file settings, the MailBounce version number and Engine number, registration information, and time and date of the run. If a problem or error condition is encountered during processing, it will be logged here. This is the most important file to review after each run and is one of the files that you should always send to us if you experience any problems.
Summary file: Provides a short summary of MailBounce's actions, as well as an abbreviated version of the Preferences settings. The Summary file includes all bounce addresses processed and tracked -- divided into those that exceeded the bounce-tracking threshold and those that did not -- and all defunct addresses that were not successfully matched against the address file.
Error Log: Provides a complete description of all address-related errors that MailBounce encountered during processing, including all recognized but unprocessed bounces, and all defunct addresses that were not successfully matched against the subscriber list. It also includes all important error messages, such as array-overflow warnings.
list server type = 'Majordomo'
list name = '<no listname>'
list password = '<no password>'
Fill these in with your list name and password. Be sure to remove the angle brackets "<" and ">") first! (Note that not all list servers require a password and/or list name on the command line; for these servers, there is no need to fill in the password and/or list name fields, as they will just be ignored by MailBounce.) Leaving the tags as shown instructs MailBounce to fill in generic information when it constructs the output (server) files; thus, if you prefer to not include this information in your Preferences file, your best bet is to leave the fields as shown above. (IMPORTANT NOTE: If you send me a copy of your Preferences file for debugging purposes, be sure to remove your password before sending the file!) Note that case is preserved in both the list name and password entries when creating the server files.
secondary list name = '<no listname>'
secondary list password = '<no password>'
Some servers require a second list name and/or password for certain actions, such as moving addresses to the BOUNCE list on Majordomo. If your server requires a separate list name and/or password for these operations, enter that information here, and it will be used automatically whenever necessary. (Pro version only)
address removal mode = 'UNSUB'
process unsub requests = 'NO'
extended unsubscribe checking = 'NO'
allow e-mail address with unsub = 'NO'
process soft bounces = 'YES'
Sites that wish to disable processing of soft bounces can do so by setting this item to 'NO'. Turning it off simply means that soft bounces are not added to the bounce array (they are still displayed during bounce processing, but are marked with a "SFT" to indicate that soft-bounce processing has been disabled). Note that turning off soft-bounce processing is not the same as turning off soft-bounce tracking. (Pro version only))
enable soft bounce tracking = 'YES'
When set to YES, this option turns on soft-bounce tracking -- meaning that your soft bounces will not be removed from the list immediately, but will be tracked over time, and will be removed once they have exceeded the threshold that you set below. When set to NO, soft-bouncing addresses will be removed from your list immediately. Refer to the Bounce_Tracking file for more information on bounce tracking. (Pro version only)
soft bounce tracking file name = 'Soft Bounce Tracking File'
Very important file (for the "Pro" version). This is where MailBounce stores the bounce-tracking (history) data for your soft bounces. Since MailBounce will need to open this file on each run, it will not insert a date stamp into the filename prior to creating the file. The tracking file is both read and written during each run; if the file is not found -- for example, the first time you run MailBounce -- a new file will be created, and MailBounce will display an information message. Note that you must have soft bounce tracking turned on for MailBounce to create this file. (Pro version only)
soft bounce threshold = '4 times'
Here is where you select the threshold for marking soft-bouncing addresses as expired (defunct). Example settings: '3 TIMES', '2 weeks', '5 days', etc. Refer to the Bounce_Tracking documentation file for details on these settings and for pointers on selecting specific settings. (Pro version only)
incremental soft bounce tracking = 'NO'
soft bounce processing interval = '0 DAYS'
soft bounce interval offset = '0 DAYS'
use incremental soft bounce threshold = 'NO'
incremental soft bounce threshold = '5 TIMES'
percentage of consecutive soft bounces required = '100'
soft bounce tracking file rollover = '0 KBytes'
This item tells MailBounce when to roll over (that is, truncate) your soft-bounce tracking file; thus, it sets an upper limit on the size of the file and/or duration of the information inside the file. The valid units are 'KBytes', 'DAYS', and 'WEEKS'. Note that a "zero" selection (e.g., '0 KBytes', as shown) will allow the tracking file to grow without bound. (Pro version only)
The behavior and settings options for the following hard-bounce settings are identical to the soft-bounce settings described above -- except, of course, that they refer to hard bounces. (Pro version only)
enable hard bounce tracking = 'NO'
hard bounce tracking file name = 'Hard Bounce Tracking File'
hard bounce threshold = '2 times'
incremental hard bounce tracking = 'NO'
hard bounce processing interval = '0 DAYS'
hard bounce interval offset = '0 DAYS'
use incremental hard bounce threshold = 'NO'
incremental hard bounce threshold = '2 TIMES'
percentage of consecutive hard bounces required = '100'
hard bounce tracking file rollover = '0 KBytes'
sort addresses = 'NO'
Turn address sorting on or off. This makes little difference for most users, since fewer than 2000 addresses will usually sort very quickly, and MailBounce will automatically turn off sorting if there are more than 10,000 addresses. However, for most users, sorting is simply unnecessary, and can be turned off.
reversed subdomain sort = 'YES'
engine only = 'NO'
track sites that are blocking mail from this list = 'NO'
mail block file name = 'mail_blocking.txt'
screen display = 'YES'
detailed display = 'YES'
For most lists, this can be left at YES. For larger lists, setting this to NO will reduce MailBounce's output, resulting in faster runs and smaller files containing less extraneous information.
display unprocessed bounces = 'YES'
notify when finished = 'NO'
notify if new server files created = 'NO'
These options will instruct MailBounce to create notification files for the purpose of process synchronization. (For example, if you want your perl wrapper to mail out the server and BCC files only if a new server file has been written.)
If you set the NOTIFY WHEN FINISHED option to 'YES', then when MailBounce finishes running, it will create a file named "all_finished.txt" in the current default directory. Also, if the "all_finished.txt" file is present in the directory when MailBounce starts up, it will automatically delete the file.
If you set the NOTIFY IF NEW SERVER FILES CREATED option to 'YES', then if MailBounce updates at least one server file, it will create a file named "server_files_updated.txt" in the current default directory. Also, if the "server_files_updated.txt" file is present in the directory when MailBounce starts up, it will automatically delete the file. If you are running a multi-list configuration, then the notification file will be created if one or more of the server files has been written; this means that there can be one or more server files that were not updated, even though the notification file was created.
The notification file names are currently fixed, though they can be made user-definable in a future release if there is demand for such a feature.
quit when finished = 'NO'
For Mac and Windows: If you want the process window to close automatically when MailBounce has finished running, then set this item to YES. Otherwise, the process window will remain open until you quit from the application.
next preferences file = 'next_prefs_filename.txt'
MacOS file type = 'TEXT'
MacOS file creator = 'ttxt'
Applicable to Macintosh users only: These settings allow you to define the format for any new files that MailBounce creates. Default settings are for "SimpleText" files (shown above), which is the format that will be used if these settings are not present in your Preferences file. Any other [valid] four-character type/creator codes may be used -- e.g., setting the creator code to 'R*ch' will cause new files to be created in "BBEdit" format. Note that these codes are case sensitive.
You can optionally specify selected file formats by name, and MailBounce will fill in the details. You may use either the MACOS FILE CREATOR setting or the MACOS FILE TYPE setting. The valid file types are 'SimpleText', 'BBEdit', and 'MS Word'. Capitalization does not matter in these settings. As an example, either of the following lines may be used to set the file type to "BBEdit":
For simplicity, the term "file type" will be used to refer to either the type code or the creator code.
MacOS file creator = 'BBEdit'
MacOS file type = 'BBEdit'
The default file type is 'SimpleText'; thus, if you remove both the MACOS FILE CREATOR and MACOS FILE TYPE settings from your Preferences file, all new files created will be in SimpleText format.
Note for Mac OS X users: Under Mac OS X, this feature is functional for files with file names of 31 characters or less. Files with longer file names will be created as generic documents; these documents can be opened in TexEdit (or any similar text editor).
This feature is not applicable to MailBounce for Darwin (i.e., the command-line version of MailBounce for Mac OS X). (Pro version only)
END CONFIGURATION
Every Preferences file should end with an "END CONFIGURATION" statement.
|
*
|
Smart Mail Solutions, Inc.
|
*
|
Columbia, Maryland, USA
|
Page last updated: 28 February 2003
|