Purpose

The look-up checks for phone number, e-mail address or e-mail domain name for outbound operations controlled by a specific user (.USR) or user job properties (.UJP) file, and if found in the specified index file the outbound operation will fail.

The check is carried out in addition to any specified global NDX look-up or global database look-up.

Specifying User-Specific Do-Not-Send look-up NDX files

There are no default files.  You must always specify an NDX filename to use this feature.

For phone number look-ups, used for fax, voice and polling outbound operations, the user-specific NDX file is specified on the $dns_file command.

For e-mail look-ups, the user-specific NDX file is specified using $var_def to assign a path to the USER_DNS_MAIL control variable in the USR or UJP file controlling the outbound call.

For e-mail domain look-ups, the user-specific NDX file is specified using $var_def to assign a path to the USER_DNS_DOMN control variable in the USR or UJP file controlling the outbound call.

The key field of the phone number NDX file should be numeric; that of the other two files should be character format, with lower case values.

A missing file will cause all look-ups to succeed, so that all transmissions will fail.

Do-Not-Send NDX file maintenance

The 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 an NDX file using IVR.

Do-Not-Send look-up exclusions

The $dns_file command may be placed in an FS file with a parameter of "none" to suppress the user do-not-send look-up for a specific item.  The control variables USER_DNS_MAIL and USER_DNS_DOMN 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 on $dns_file or in these FS-file variables are ignored.

Failure Outcome codes

Phone and E-mail look-up failures: 76
Domain look-up failures:           84
NDX Look-up file not found:        80