Configuration and Setup > The Do-Not-Send Files > User-Specific Do-Not-Send NDX lookup

Purpose

The lookup 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 lookup or global database lookup.

Specifying User-Specific Do-Not-Send lookup NDX files

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

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

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

For e-mail domain lookups, the user-specific NDX file is specified using $var_def to assign a path to the USER_DNS_DOMN system 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 lookups 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 lookup exclusions

The $dns_file command may be placed in an FS file with a parameter of "none" to suppress the user do-not-send lookup for a specific item. The system 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 lookup. 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 lookup failures: 76
Domain lookup failures: 84
NDX Lookup file not found: 80.

Topic url: http://www.copia.com/support/refmanual/index.html?user_specific_do_not_send_ndx.htm