Summary

CopiaFacts supports three types of look-up index files:

Plain text files, one entry per line, are supported for launch-time look-up and for the FAXFACTS.CFG commands $action_phone and $dns_phone.

No action needed because any 10-digit NANP numbers will be loaded as 11-digit.  However if you are using a 'partial-match' list of country/area codes only, for example in an action list to process calls to a specific province or country specially, these cannot be modified automatically as 10-digit numbers are, and should preferably include the '1'.  Currently, however, two lookups are done on plain text files, with and without the 1 on the tested number.

NDX files are supported for launch-time look-up and for the FAXFACTS.CFG commands $action_phone and $dns_phone, for the global do-not-send file DNS.NDX and its override path specified by DNS_PATH, and for user-specific Do-Not-Send files specified with $dns_file.

No immediate action needed because two lookups will be done, with and without leading 1
NDX files can be rebuilt as all 11-digit NANP, plus domestic, using PIN
PIN and DNSUPD will maintain NDX files with 11-digit-only NANP entries
Other user-supplied apps must maintain NDX files with 11-digit-only NANP entries

Database look-up is supported for launch-time look-up and for the FAXFACTS.CFG commands $action_phone and $dns_phone, for a global do-not-send database specified by DNS_PATH, and for a user-specific Do-Not-Send database specified with $dns_file.

No immediate action needed because two lookups will be done, with and without leading 1
If both 10- and 11-digit entries are present with different action codes, either action code may result.
User-supplied apps must maintain tables with 11-digit-only NANP entries.

See the following topics for more detailed explanations.

Plain Text Look-Up Files in the NANP area other than USA and Canada

Plain text look-up files are loaded dynamically into a look-up index. If you have no $country_code command you should duplicate NANP international entries with and without a leading 1 unless you can ensure that numbers are always entered as 10 digits, or always as 11 digits, in faxing from the desktop or broadcast lists, in which case only the matching format is needed in your index.

If you have a $country_code command with a value starting with 1 then everything will 'just work' whether or not the NANP international numbers in your list are 10 or 11 digits.  This is because the dynamic index will be built so that all NANP international numbers will have a leading 1, and all such numbers presented to be looked up will have a 1.  Other international numbers in the list may either have the standard form (for example +441672841396) or be entered with the dial prefix in place (for example 011441672841396). The international prefix will be stripped before loading and before look-up.

If both 10- and 11-digit entries are present with different action codes, the action code selected on a look-up may be either one of the codes.

Seven-digit domestic numbers must be entered these as 7-digit numbers in your look-up files when needed.

NDX Look-Up Files in the NANP area other than USA and Canada

If you have no $country_code command you should duplicate the NANP international entries with and without a leading 1 unless you can ensure that numbers are always entered as 10 digits, or always as 11 digits, in faxing from the desktop or broadcast lists, in which case only the matching format is needed in your index.

If you install a new CopiaFacts system, a $country_code command will be added automatically by the server configurator (SERCONF) and everything will 'just work' whether or not the NANP international numbers in your list are 10 or 11 digits.  This is because NDX files maintained by PIN or DNSUPD are built so that all NANP international numbers will have a leading 1, and all such numbers presented to be looked up will have a 1. Other international numbers added by PIN or DNSUPD may either have the standard form (for example +441672841396) or be entered with the dial prefix in place (for example 011441672841396). The international prefix will be stripped by PIN and DNSUPD before loading, and before look-up, but if you maintain the NDX with other applications it is your responsibility to strip the international dial prefix from index entries..

If both 10- and 11-digit entries are present with different action codes, the action code selected on a look-up may be either one of the codes.

If you add a $country_code command with a value starting with 1 and have existing NDX files, then initially two look-up operations will be done for each 11-digit NANP number presented to be matched, first for the number as presented, and second with the leading 1 stripped.  To avoid this duplication, you should rebuild your NDX files as soon as possible, using PIN version 8.2 or later. Each index file needs to be processed using the PIN i command, for example:

PIN @FFLOG\DNS.NDX i

This re-index operation marks the file as containing NANP numbers with a leading 1 and changes ten-digit numbers to have a 1.  It also marks the NDX file to indicate that the duplicated look-up is no longer required. A backup is made (.001, .002 etc.) when the file is re-indexed.

If you maintain NDX files other than with PIN and DNSUPD, it is your responsibility to switch to using only 11-digit numbers: ten-digit numbers in the file will no longer be matched and faxes may be sent to such numbers.

Seven-digit domestic numbers must be entered these as 7-digit numbers in your look-up files when needed.

Database Look-up in the NANP area other than USA and Canada

If you have no $country_code command you should duplicate the NANP international entries with and without a leading 1 unless you can ensure that numbers are always entered as 10 digits, or always as 11 digits, in faxing from the desktop or broadcast lists, in which case only the matching format is needed in your database table.

If you install a new CopiaFacts system, a $country_code command will be added automatically by the server configurator (SERCONF) and everything will 'just work' provided you arrange for all NANP international numbers in your database table to have 11 digits.  Other international numbers must have any leading + sign or international dial prefix stripped (for example 441672841396): it is the responsibility of the maintaining application to do this.

If you add a $country_code command with a value starting with 1 and have existing database tables, then initially two look-up operations will be done for each NANP international 11-digit number presented to be matched, first for the number as presented, and second with the leading 1 stripped.  To avoid this duplication, you must modify your database tables to hold only 11-digit NANP numbers as soon as possible, and then add the DBOK parameter to the $country_code command to suppress the double look-up.

Seven-digit domestic numbers must be entered these as 7-digit numbers in your look-up files when needed.