Purpose
The look-up checks for phone number, e-mail address or e-mail domain name for all outbound operations, and if found in the specified index file the outbound operation will fail.
Default Do-Not-Send look-up NDX files
The following standard dBASE index files, when placed in the LOG folder (or the folder specified by $log_def) will be used if present.
| DNS.NDX | an index file containing phone number key values in numeric format. This look-up is used for fax, voice and polling outbound operations. |
| DNS_MAIL.NDX | an index file containing lower-case e-mail address key values in character format |
| DNS_DOMN.NDX | an index file containing lower-case e-mail address domain key values in character format |
If the file is missing and no overrides are provided, no exclusions are made.
Overriding Do-Not-Send look-up NDX filenames
The control variables DNS_PATH, DNS_MAIL_PATH and DNS_DOMN_PATH may be assigned in FAXFACTS.CFG to override the normal path in the log directory for the corresponding file, or to specify a file with a non-standard name.
When this is done a missing file will cause all look-ups to succeed, so that all transmissions will fail.
Do-Not-Send NDX file maintenance
The CFUTIL PIN command-line utility program provides a simple way to maintain NDX files for this purpose. It can be used in a command file and the DNSADD example application demonstrates how to maintain a DNS.NDX file using IVR.
Do-Not-Send look-up exclusions
The control variables DNS_PATH, DNS_MAIL_PATH and DNS_DOMN_PATH may be assigned a value of NONE in an FS file to exclude the transmission from do-not-send look-up. This may be useful when sending a fax or email to the target to confirm that the exclusion has been recorded. Values of other than NONE in these FS-file variables are ignored.
Failure Outcome codes
Phone and E-mail look-up failures: 75
Domain look-up failures: 84
Look-up file not found: 80