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 domestic numbers will be loaded as 11-digit.  However if you are using a 'partial-match' list of area codes only, for example in an action list to process calls to a specific state 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 using PIN
PIN and DNSUPD will maintain NDX files with 11-digit-only domestic entries
Other user-supplied apps must maintain NDX files with 11-digit-only domestic 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 look-ups will be done, with and without leading 1
User-supplied apps must maintain tables with 11-digit-only domestic entries

See the following topics for more detailed explanations.

Plain Text Look-Up Files in the 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 the 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 of 1 then everything will 'just work' whether or not the domestic numbers in your list are 10 or 11 digits.  This is because the dynamic index will be built so that all domestic numbers will have a leading 1, and all numbers presented to be looked up will have a 1.  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 or plus sign 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.

If you expect to process 7-digit local numbers from the desktop client or in broadcast lists, you must enter these as 7-digit numbers in your look-up files when needed, in addition to the number with its area code if you also expect this format.  It is better to use only numbers with an area code if this can be enforced.  The $phone_mask will specify how such numbers are actually dialed.

NDX Look-Up Files in the USA and Canada

If you have no $country_code command you should duplicate the 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 domestic numbers in your list are 10 or 11 digits.  This is because NDX files maintained by PIN or DNSUPD are built with all numbers having a leading 1, and all numbers presented to be looked up will have a 1. 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 or plus sign 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 of 1 and have existing NDX files, then initially two look-up operations will be done for each 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 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.

If you expect to process 7-digit local numbers from the desktop client or in broadcast lists, you must enter these as 7-digit numbers in your look-up files when needed, in addition to the number with its area code if you also expect this format.  It is better to use only numbers with an area code if this can be enforced.  The $phone_mask will specify how such numbers are actually dialed.

Database Look-up in the USA and Canada

If you have no $country_code command you should duplicate the 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 domestic numbers in your database table to have 11 digits.  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 of 1 and have existing database tables, then initially two look-up operations will be done for each 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.

If you expect to process 7-digit local numbers from the desktop client or in broadcast lists, you must enter these as 7-digit numbers in your look-up tables when needed, in addition to the number with its area code if you also expect this format.  It is better to use only numbers with an area code if this can be enforced.  The $phone_mask will specify how such numbers are actually dialed.