Page 1
International ACE
Release Notes
Install by
You must install this release
by 31 December 2007 to satisfy
AMAS requirements.
For information about known
issues and tips on running your
job, see the read_iace.txt file
included with the installation
CD.
International ACE 7.80c Revision 1
November 2007
Page 2
Contact information Contact us on the Web at http://www.firstlogic.com/customer
Patents Business Objects owns the following U.S. patents, which may cover products that are
offered and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2,
6,490,593 and 6,289,352.
Trademarks Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise
are trademarks or registered trademarks of Business Objects SA or its affiliated
companies in the United States and other countries. All other names mentioned herein
may be trademarks of their respective owners.
Copyright If you find any problems with this documentation, please report them to Business
Objects in writing at documentation@businessobjects.com
.
Copyright © 2007 Business Objects. All rights reserved.
Third-party contributors
Business Objects products in this release may contain redistributions of software
licensed from third-party contributors. Some of these individual components may
also be available under alternative licenses. A partial listing of third-party
contributors that have requested or permitted acknowledgments, as well as required
notices, can be found at http://www.businessobjects.com/thirdparty
2
International ACE Release Notes
Page 3
What’s included in this release
Contents Install International ACE .................................................................................5
Compile and run the International engine........................................................6
Australia engine updates ..................................................................................8
U.S. engine updates........................................................................................11
Canada engine: SERP certification and updates ............................................16
Japan engine: enhanced assignment...............................................................17
Updates to components ..................................................................................18
Assignment changes.......................................................................................19
What’s in your package
Product keyfile compat
Australia engine updates
Updates to handling Unicode input data: all engines
International directory files
In your package today, you’ll find the following:
International ACE 7.80c software
International ACE 7.80c release notes (this document)
International Address Processing: Install the UNIX Runtime Environment
(For UNIX operating systems only)
Install International ACE 7.80c Revision 1 at your earliest convenience to ensure
keyfile compatibility with other Business Objects products that you may own.
The Australia engine is certified for AMAS Cycle 2008 and includes several
updates. See “Australia engine updates” on page 8 for details.
When the input data contains characters beyond the Latin code page (Basic Latin,
Latin-1, and Latin1-Extended A) all engines now return a fault code of F500 and
the input data will be returned in the Standardized output lines as well as the
discrete output field “Extra”. The same behavior will be exhibited by US,
Canadian and Australian engines when the Input data contains characters beyond
the Basic Latin and Latin-1 code page.
New directory files are required for this release. You need to install Version 7.80c
and the updated directory files to ensure proper address assignment. The new
directory files were included in the October 2007 directory update (located on the
directory CD in x:\). See the October 2007 International directory letter for
detailed installation instructions.
U.S. engine updates The U.S. engine includes several updates. For details, see “U.S. engine updates”
on page 11.
Canada engine updates
The Canada engine is SERP certified through June 2008 and includes several
updates to the assignment logic. See “Canada engine: SERP certification and
updates” on page 16.
Japan engine updates The Japan engine includes several updates to the assignment logic and a newly
formatted directory files that support all platforms are available with this release.
For details, see “Japan engine: enhanced assignment” on page 17.
What’s included in this release
3
Page 4
Updated and new components
This release includes updates to an existing component and new components. For
details, see “Updates to components” on page 18.
EasyIQ EasyIQ no longer returns hyphenated secondary ranges as seen in the directory
files for Australian addresses.
Previous versions returned Version 7.80c correctly returns
Suite 1-10 5 Main St. Suite 5 Level 2 10 Main St.
Assignment changes This release includes several changes to the way International ACE assigns
addresses. See “Assignment changes” on page 19.
Documentation
Complete documentation
set
Access the latest
documentation
The complete International ACE documentation set includes the following:
International ACE Job-File Reference (if you use International ACE job file)
International ACE Library Reference (if you use International ACE Library)
Quick Reference for Views and Job-File Products (if you use International
ACE Views, job file, or RAPID)
Quick Reference for Library Products (if you use International ACE Library)
System Administrator’s Guide
International Address Processing: Install the UNIX Runtime Environment (if
you use the International engine on a UNIX platform)
Edjob User’s Guide (if you use International ACE job file or RAPID)
Database Prep (if you use International ACE Views, job file, or RAPID)
Views Quick Start Guide (if you use International ACE Views)
International ACE Remote Views Installation Guide (if you use International
ACE Remote Views or RAPID)
You can access documentation in several places:
On your computer. Release notes, manuals, and other documents for each
product that you’ve installed are available in the Documentation folder.
Choose Start > Programs > Business Objects Applications >
Documentation.
On the Customer Portal. Go to www.firstlogic.com/customer, and then
click the Documentation link to access all the latest product documentation.
You can view the PDFs online or save them to your computer for viewing or
printing.
4
International ACE Release Notes
Page 5
Install International ACE
Installation advice To simplify installation, read the following tips before you begin:
You should give the contents of this software shipment to your system
administrator. Business Objects recommends that our software be installed
only by, or with the approval of, the system administrator.
Although you can install your applications and directories in any order, we
recommend that you install software first and then directories.
If you install on multiple operating systems, check the bottom of the CD label
for the appropriate operating system.
Install on Windows When you insert the CD, the installation program should start automatically. If it
doesn’t, follow these steps:
1. Access your Windows Start menu and choose Run.
2. In the Run window, type x:\setup (where x is the letter of your CD-ROM
drive) and click OK. The installation program should start.
Install International ACE 7.80c in a directory called pw. Be sure to install all
supporting directory files. Run International ACE directly from the appropriate
subdirectory (for example, pw\iace or pw\iacelib).
For details, see the System Administrator’s Guide.
Install on UNIX To install, run the UNIX install_console. For more information, see the System
Administrator’s Guide.
Operating system versions
Client shortcuts If you have International ACE installed on one computer, but you run it from
Run International ACE on one of our supported operating systems, which are
listed at http://www.firstlogic.com/customer/InfoSource/SystemInformation.asp
another computer using client shortcuts, you must refresh your client-side
shortcuts by using the Universal Client installer.
Job and RAPID users: Run Edjob
If you use International ACE Job, update your job files using the version of Edjob
installed in the pw\adm directory for Windows and the postware/adm directory
for UNIX. The general form of the command line is as follows.
edjob [options] [path]pwiacjob.upd job_file.iac
The International ACE update script, pwiacjob.upd, is located in the iace
subdirectory. In the Auxiliary Files block of each job, adjust the path names to
refer to your directories (for example, pw\dirs and pw\iace). This ensures that the
software uses the current versions of the dictionaries and postal directories.
Install International ACE
5
Page 6
Compile and run the International engine
If you use the International engine, we advise you to use the Country ID
!
engine when processing jobs. If you use two or more country engines, you
must use the Country ID engine.
COBOL runtime environments and fixpacks
UNIX users: Configure your system
If you install and run the International engine on AIX, HP, Linux, or Solaris, you
must manually set up the COBOL runtime environment. The following versions
and fixpacks are available.
UNIX Platform COBOL version Fixpack version
AIX 5.2 32-bit version 4.0 SP2 fixpack40.02_65
AIX 5.2 64-bit version 4.0 SP2 fixpack40.02_65
HP11 32-bit/64-bit version 4.0 SP2 fixpack40.04_63
HP11 Itanium 64-bit version 4.0 SP2 fixpack40.04_63
Linux Advanced Server 3.0 32-bit version 4.0 SP2 fixpack40.03_46
Linux Advanced Server 4.0
32-bit/64-bit
Linux SuSe 8.0 32-bit version 4.0 SP2 fixpack40.01_46
Linux SuSe 9.0 64-bit version 5.0 N/A
Solaris 8/9/10 SPARC 32-bit/64-bit version 4.0 SP2 fixpack40.01_63
version 5.0 N/A
The International engine relies on specific environment variables being set in
order to run successfully. All examples are shown using the bash shell. Make
adjustments for the shell that you are using.
1. To set the COBDIR variable to the location where the system administrator
has installed the MicroFocus COBOL environment, type COBDIR=/opt/lib/
cobol and press Enter. Then type export COBDIR and press Enter.
2. To set the TCGLOG variable, type TCGLOG=/<path>/postware/iacelib/
work/tcglog.txt and press Enter. Then type export TCGLOG and press
Enter. If you do not name the file, it defaults to tcglog.txt and places it in the
location in which you are running.
3. Set the Shared Library Path environment variable. This command varies
according to your operating system.
HP
AIX
Solaris
Linux
6
International ACE Release Notes
Type
SHLIB_PATH=$COBDIR/lib:
adm
and press Enter. Then type export SHLIB_PATH
Type
LIBPATH=$COBDIR/lib:
and press Enter. Then type
Type
LD_LIBRARY_PATH=$COBDIR/lib:
postware/adm and press Enter. Then type export LD_LIBRARY_PATH
and press Enter.
Type
LD_LIBRARY_PATH=$COBDIR/lib:
postware/adm:/usr/local/gcc.3.2.3/lib
LD_LIBRARY_PATH
export LIBPATH
and press Enter.
installation path
installation path
and press Enter. Then type
:/disk_n
and press Enter.
installation path
installation path
:/disk_n/postware/
and press Enter.
/postware/adm
:/disk_n
:/disk_n
/
/
export
Page 7
4. To increase the number of file handles available, type ulimit –Sn 1024.
C Shell users: type limit descriptors 1024.
5. Library users: adjust your path variable to include the $COBDIR/bin
directory. Type PATH=$COBDIR/bin:$PATH and press Enter. Then type
export PATH and press Enter.
Required compiler upgrades
HP platform: Library users
HP platform: Job users
Library/RAPID users: adjust the path
There are several required compiler upgrades for Business Objects products. See
the notes from the 2007 Coordinated Suite Release for details.
https://customer.firstlogic.com/InfoSource/article.asp?iArticleID=415
In order for your executable to run successfully on the HP platform, locate the
executable in the same directory as the International ACE files or have each user
set the environment variable COBPATH to the install directory.
If you run the International ACE Job file from an area other than the install
directory, you need to set the COBPATH environment variable to include the
install directory. In addition, all sample job files are designed to run in the sample
directory. You need to set this COBPATH environment variable to include the
install path before you can successfully complete a sample job on the HP
platform.
Be sure to adjust your path to include the location of the linker (ld) command and
the assembler (as) command. For example:
To adjust your path variable to include the location of the linker (ld)
command, type PATH=/usr/ucb/bin:$PATH and press Enter.
To adjust your path variable to include the location of the assembler (as)
command, type PATH=/usr/ccs/bin:$PATH and press Enter.
Windows users: configure your system
All library users: set file location
If you install and run the International engine on Windows, you do not need to set
up a runtime environment because the runtime environment is automatically
installed on the Windows platform. However, you do need to set environment
variables.
You must set the TCGLOG to a valid path and file name. You may give this file
any name. If you do not name the file, it will default to tcglog.txt. Do one of the
following:
At the DOS prompt, type set TCGLOG=\<path>\pw\iacelib\work\
tcglog.txt
In your operating system startup file, add the TCGLOG variable to include a
path of \<path>\pw\iacelib\work\tcglog.txt
If the environment variable for TCGLOG is not valid, International ACE will
stop running and bring you back to the prompt soon after processing begins.
To correct this, set the TCGLOG to reflect a valid path.
The files iiemsg.dbf and cppgmsg.dbf must be in your PATH.
Compile and run the International engine
7
Page 8
Australia engine updates
AMAS Certification This release includes the assignment changes necessary to be approved by
Australia Post in accordance with the Address Matching Approval System
(AMAS) Cycle for 2008.
New directory format Version 7.80c requires the use of a new directory format. The new directory files
were included with the October 2007 directory update. The new files are located
in the AMAS2007 folder on the Directory update CD. All files previously located
in AMAS2006 are located in AMAS2007.
Assignment updates and improvements
improvements to
Bordering locality
matching
Bordering locality in a
different region
Update status code for
changes to bordering
locality
updates to unit descriptor
parsing
This release includes improvements that provide better matching capability in
accordance to the 2008 AMAS bordering locality matching rules. For details, see
chapter 18.4 “Bordering Locality Matching (BLM) Rules” in the 2008
AMAS Handbook. http://www.auspost.com.au/GAC_File_Metafile/
0,,3421_2008_amas_handbook_15_19_v1,00.pdf
Previous versions of the Australian engine did not make an assignment when a
bordering locality existed in a different region. The new directory data for
Australia enables the Australia engine to recognize that a bordering locality exists
in a different region and make an assignment.
In the previous versions, the Australia engine did not recognize a change to the
bordering locality as a change and update the status code. Version 7.80c
recognizes the change and updates the status code.
This release includes updates to ensure proper parsing of unit descriptors.
Example 1:
Version 7.70c, recognized 33 as a primary street range. Version 7.80c, now
recognizes 33 as a Unit number. It treats this type of input address as missing
primary range and returns a fault code of F420.
Input
Locality
Region
Postcode
Country
8
International ACE Release Notes
Silverwater
NSW
2128
Australia
unit 33 Slough Avenue Business Park Holker Street
line1:
Page 9
Example 2
Previous versions incorrectly parsed the unit descriptor when extra data or firm
data contained a word similar to a unit descriptor word (OF, SE, C, HOUSE,
ROOM, or SITE). Version 7.80c correctly parses words similar to descriptor
words.
Input
line1:
line2:
line3:
Previous versions
Church of Scientology
201 Castlereagh St
Sydney NSW 2000
Unit Descriptor:
Remainder 1:
Version 7.80c
Extra 12:
Example 3:
line1:
OF 201 CASTLEREAGH ST CHURCH SCIENTOLOGY
line2:
line3:
SYDNEY NSW 2000
line4:
AUSTRALIA
OF
CHURCH SCIENTOLOGY
201 CASTLEREAGH ST CHURCH OF SCIENTOLOGY
line1:
line2:
SYDNEY NSW 2000
line3:
AUSTRALIA
line4:
CHURCH OF SCIENTOLOGY
Previous versions recognized some street types as unit descriptors and parsed the
the data as street type and a unit descriptor.In this example, Flat is parsed as a unit
descriptor and as the street type. Version 7.80c correctly parses Flat as the street
type.
Input
line1:
line2:
Previous versions
4 Mitchell Flat
SA 5417
line1:
line2:
line3:
Primary Range:
Primary Name 1:
Unit Descriptor:
Region 1:
Postcode 1:
Postcode Full:
4 MITCHELL FLAT
SA 5417
AUSTRALIA
4
MITCHELL
FLAT
SA
5417
5417
Australia engine updates
9
Page 10
Version 7.80c
Primary Range:
Primary Name 1:
Postcode Full:
line1:
line2:
line3:
Street Type 1:
Region 1:
Postcode 1:
4 MITCHELL FLAT
SA 5417
AUSTRALIA
4
MITCHELL
FLAT
SA
5417
5417
10
International ACE Release Notes
Page 11
U.S. engine updates
The International ACE U.S. engine includes the following changes.
USPS 3553 Report removed
The USPS 3553 Report is no longer available in version 7.80c. International ACE
does not include LACSLink processing and therefore cannot be used for CASS
certification per USPS regulations.
New directories International ACE now has two new directories that enhance the U.S. engine’s
street name lookup processes.
zip4us.rev The reverse soundex directory enhances street name lookups.
For International ACE Job and Views, the zip4us.rev directory is always enabled.
The zip4us.rev directory is included on the U.S. National directories CD.
Make sure that you include this directory when you install the software or
directory updates. Set the path for this directory in the Reverse Soundex
Directory option in the Auxiliary Files block.
BEGIN US Auxiliary Files
======================================
City Directory (path & city09.dir)... = city09.dir
ZCF Directory (path & zcf09.dir)..... = zcf09.dir
ZIP+4 Directory 1 (path & zip4*.dir). = zip4us.dir
ZIP+4 Directory 2 (path & zip4*.dir). =
Rev ZIP+4 Dir (path & revzip4.dir)... = revzip4.dir
Rev Soundex Dir(path & zip4us.rev)... = zip4us.rev
ZIP+4 SHS Dir (path & zip4us.shs).... = zip4us.shs
EWS Directory (path & ewyymmdd.dir).. = ew*.dir
eLOT Directory (path & elot.dir)..... = elot.dir
RDI Directory (path only)............ =
DPV Directory (path only)............ =
Firm Line Dct (path & firmln.dct).... = firmln.dct
Addr Line Dct (path & addrln.dct).... = addrln.dct
Last Line Dct (path & lastln.dct).... = lastln.dct
Casing Dct (path & pwcas.dct)........ = pwcas.dct
END
U.S. engine updates
11
Page 12
zip4us.shs The SHS directory enhances normal street name lookups.
The zip4us.shs directory must be installed and the location set in your job. IACE
will issue errors if you do not do this.
Example 1 Example 2
Input
Output
Library updates zip4us.rev
Call the zip4us.rev directory by passing the directory location to the library using
the following file define with the setFile(), and getFile() functions:
EngineFileEnum File name
ENGINE_DIR_REV_SOUNDEX
zip4us.shs
Call the rev4us.shs directory by passing the directory location to the library using
the setFile(), and getFile() functions:
EngineFileEnum File name
1 cchoolhouse Rd
Amherst MA 01002
1 Schoolhouse Rd
Amherst MA 01002-9603
Input
Output
zip4us.rev
33 ashington ave
Northampton MA 01060
33 Washington Ave
Northampton MA 01060-2822
ENGINE_DIR_ZIP4_SHS
zip4us.shs
12
International ACE Release Notes
Page 13
New DPV options We’ve changed the DPV options in International ACE to support CASS Cycle L
requirements. And we’ve added a new non-Certified option that enables
International ACE to assign a ZIP+4 when an address does not DPV-confirm.
Perform DPV Processing (Y/N)
Assign ZIP+4 to Non DPV Confirmed (Y/N)
Perform DPV Processing
option
The option “DPV Mode” is replaced with “Perform DPV Processing (Y/N).” You
no longer have the DPV options to validate (determine if addresses are valid
delivery points) and tiebreak (enable DPV to assist in tie-breaking during address
processing) because International ACE does these automatically. International
ACE still returns DPV footnote codes.
The “Perform DPV Processing” option in the Execution block is disabled by
default.
BEGIN US Processing Options
===================================
Assignment Mode (ASSIGN/PARSE/GEO)... = Assign
Assign Which Records (ALL/UNASSIGNED) = All
Perform Z4Change Processing (Y/N).... = N
Perform GeoCensus Processing (Y/N)... = N
Perform EWS Processing (Y/N)......... = N
Perform eLOT Processing (Y/N)........ = N
Perform RDI Processing (Y/N)......... = N
Perform DPV Processing (Y/N)......... = N
Enable Non-Certified Features (Y/N).. = N
END
Enable DPV processing in
Library
AssignEngOptionEnum AssignEngOptionValueEnum Description
The modes for DPV Tiebreaking, Validation, and Both have been removed. the
following options are now available.
ASSIGN_ENG_MODE_DPV ASSIGN_ENG_MODE_DPV_YES Enable DPV processing
ASSIGN_ENG_MODE_DPV_NO
Disable DPV processing.
(default)
U.S. engine updates
13
Page 14
Assign ZIP+4 to Non DPV
Confirmed
If you disable DPV processing but still want to retain the ZIP+4 information,
make sure that you enable the new Assign “ZIP+4 to Non DPV Confirmed”
parameter in the U.S. Non-Certified Options block.
BEGIN US Non-Certified
========================================
Accept Input Postcode if SMatch (Y/N) = Y
Inexact Postcode Move Forwarding(Y/N) = Y
Assign ZIP+4 to Non DPV Confirmed(Y/N). = Y
END
Caution: International
!
disable DPV processing and disable the “Assign ZIP+4 to Non DPV Confirmed”
ACE blanks out
all
ZIP+4 information in your data if you
option. This includes ZIP+4 information provided in your input file.
Examples These examples show how the U.S. engine assigns the ZIP+4:
Perform DPV Processing
(U.S. Processing Options block)
Enable Non-Certified Features
(U.S. Processing Options block)
Assign ZIP+4 to
Non DPV Confirmed
(U.S. Non-Certified block)
Y (enabled) N (disabled) N (disabled) Yes
International ACE does
not assign a ZIP+4 due to
a DPV Status on N
Input
AP.DPV_Status
Output
211 Andrews Dr
Tuscumbia TX 35674
N
211 Andrews Dr
Tuscumbia AL 35674
International ACE outputs the following DPV footnotes:
AA = input address matches to the ZIP+4 file
M3 = input address primary number is invalid
ZIP+4 assigned
International ACE assigns
a ZIP+4 due to a DPV
status of Y
14
International ACE Release Notes
Input
6750 West Loop S STE 410
Bellaire TX 77401
AP.DPV_Status
Output
Y
6750 West Loop S STE 410
Bellaire TX 77401-4197
International ACE outputs the following DPV footnotes:
AA = input address matches to the ZIP+4 file
BB = all input address fields match to DPV
Page 15
Enable the Assign ZIP+4
to Non DPV Confirmed
option in Library
AssignEngOptionEnum AssignEngOptionValueEnum Description
To set the Assign ZIP+4 to Non DPV Confirmed option in Library, call
getOption() and setOpion() with one of the following values.
ASSIGN_ENG_NC_ZIP4_
WITHOUT_DPV
New F601 fault code The new Error code, F601, informs you when the primary address number did not
ASSIGN_ENG_NC_ZIP4_WITHOUT_
DPV_YES (default)
ASSIGN_ENG_NC_ZIP4_WITHOUT_
DPV_NO
Assign ZIP+4 to Non DPV Confirmed addresses
Do not assign ZIP+4 to Non DPV
Confirmed addresses.
DPV confirm, and the ZIP+4 was removed. F601 is output in the AP.Fault_Code
field (for Library, NAD_ERR_NO_DPV). This fault code is returned when DPV
is disabled or you do not own the DPV option.You won’t see this error if you have
enabled the U.S. Non-Certified option to assign the ZIP+4 to non-DPV-confirmed
addresses.
DPV in Quick IACE The U.S. Non-Certified option to assign a ZIP+4 to non-DPV-confirmed
addresses is enabled by default. However, Quick IACE provides an option to turn
it off in the Quick IACE Options - United States window.
U.S. engine updates
15
Page 16
Canada engine: SERP certification and updates
SERP certification This release continues the SERP recognition until 30 June 2008. Several
enhancements are available in parsing and assignment logic to handle more
address formats and improve our SERP test scores.
Address assignment correction
Parsing updates This release includes several fixes to minor parsing issues, which will allow for
There are several updates to the address assignment logic.
more flexibility in terms of how clean addresses must be on input.
Rangeless addresses In previous versions, the Canada engine produced invalid results when processing
rangeless addresses found specifically on streets served by rural service
addresses. Version 7.80c correctly assigns these instances of rangeless addresses.
Status codes In previous versions, there were inconsistencies caused by the way that the status
codes were generated. Updates to the assignment logic corrects this issue. You
may notice widespread changes to status codes, and some significant changes in
category codes.
16
International ACE Release Notes
Page 17
Japan engine: enhanced assignment
identify the address components with missing markers
The Japan engine is now able to identify the address components with missing
markers and assign and standardize them in the official format with kanji
markers.
Input
Output
8128564
8128564, 福岡県 , 福岡市 , 博多区 , 冷泉町 ,4 番地 ,17 号
,
福岡 , 福岡 , 博多 , 冷泉 , ４番地 , １７号
This feature only populates missing markers for prefecture, city/island, ward/
county/village, district, and sub district components. The Japan engine continues
to populate missing markers in block data based on pattern format as in previous
versions.
Assign addresses on Postcode only
The Japan Engine is now able to populate the entire LOPC address data when
only the LOPC Postcode is available on input. The Japan engine cannot populate
the MPT addresses with the MPT Postcode only
Input
Output
Japan directory files The Japan directory files are now available in a new format that supports all
8128564
8128564
,
福岡県 , 福岡市 , 博多区 , 冷泉町 ,4 番地 ,17 号
platforms. You now use the same format for all platforms. This eliminates the LE
and BE versions of directories and pattern file for version 7.80c. The new files are
located at the root of the October directory CD (x:\).
This new directory format is not backwards compatible with prior versions. The
older version of the directory files will still be provided along with the new
format on the directory update CD.
For complete installation instructions, See the Directory Update for Japanese
Products letter for October.
Japan engine: enhanced assignment
17
Page 18
Updates to components
Canada engine The Canada engine now supports the following components.
Output component Length Description
AP.Postal_NUM (Job)
NAD_POSTAL_NUM
(Library)
AP.Rural_Num (Job)
NAD_RURAL_NUM
(Library)
International engine The International engine now supports the following components.
Component Length Description
AP.Unit_Num (Job)
NAD_UNIT_NUM
(Library)
AP.Unit_Desc (Job)
NAD_UNIT_DESC
(Library)
Up to 100 Includes the numeric portion of the post-
office box number.
Up to 100 Includes the numeric portion of the rural
route address.
Up to 100 Unit number.
Up to 100 Unit description, such as “Apartment” or
“Flat.”
18
International ACE Release Notes
Page 19
Assignment changes
There are several changes made to the way International ACE makes
assignments. The assignment changes are as follows.
PL incorrectly recognized for Norway
PL incorrectly recognized for Sweden
Post box information in German addresses
In previous versions PL was recognized as a Postbox indicator rather than Plass
(Square) within Norwegian addresses. Version 7.80c correctly recognizes PL as
Plass (Square).
In previous versions PL was recognized as PO Box rather than the abbreviation
for Postlåda (PL). Version 7.80c recognizes PL and Postlåda and assigns
accordingly.
In previous versions, Post bus and Post fach were not recognized as valid
variations of Postbus and Postfach in German addresses. Version 7.80c correctly
recognizes these variations and returns the correct PO Box information.
Post box information in Italian addresses
PN improvements for Netherlands addresses
Serbia and Montenegro
Country name Abbr. ISO
In previous versions, Casale Postale was returned for an Italian Postbox address.
Version 7.80c correctly returns the Postbox information as Casella Postale.
Updates to assignment logic allow for more accurate primary name assignment
for Netherlands addresses.
Serbia and Montenegro are now recognized as two separate countries.
Code
European
Pcode prefix.
Engine Level of address correction
supported
Montenegro ME 449 Intl
Serbia RS 688
Discrete country name assignment
In some instances, previous versions of the International engine did not recognize
the input locality and changed the discrete country name on output. Version 7.80c
Intl
will not retry an address when a discrete country name is available on input.
Locality assignment for Marshall Islands and Micronesia
In previous versions, the International engine made a country-level assignment to
addresses in Marshall Islands and Micronesia when a locality-level match was
possible. Version 7.80c correctly assigns to the locality level.
Locality Street Premise
X
X
Assignment changes
19
Page 20
Parsing of secondary information
In previous versions, the International engine identified address information that
did not include a unit description and unit number as a secondary address. Version
7.80c only populates the secondary address output field when the input data
contains the secondary unit description and the secondary unit number. It also
returns non-secondary address data in the Extra components. This change
prevents non-secondary address data from being interpreted as secondary address
data.
This change applies to the following countries:
Australia (International engine only)
Austria
Brazil
Canada (International engine only)
Cyprus
France
Greece
New Zealand
Poland
Portugal
South Africa
Switzerland
USA (International engine only)
Example 1
In this example, previous versions returned “Badische Beamtenbank Eg” as a
secondary address. Version 7.80c returns “Badische Beamtenbank Eg” in the
Extra component
Input
country:
line1:
line2:
line3:
line4:
Badische Beamtenbank Eg
Hengstplatz 9
Durlach, Karlsruhe
76117
GERMANY
line5:
20
International ACE Release Notes
Page 21
Example 2
Version 7.80c returns secondary address information in the Unit Number and Unit
Description components.
Input
country:
NEW ZEALAND
MATRIX APPLIED COMPUTING
line1:
UNIT 2
line2:
72 DOMINION ROAD
line3:
AUCKLAND
line4:
NEW ZEALAND
line5:
98814 FAYAOUE OUVEA
line6:
line7:
line8:
Previous versions Version 7.80c
Primary Range:
Primary Name 1:
Street Type 1:
Address:
Secondary Address:
72
DOMINION ROAD
RD
2-72 DOMINION ROAD
UNIT 2
Primary Range:
Primary Name 1:
Street Type 1:
Unit Number:
Unit Description:
Secondary Address:
Country-level assignments
The International engine will populate the Extra output fields with the address
and last line information that was input. The engine no longer populates the
address line output fields and last line discrete output fields with the exception of
Country Name and ISO code. This change prevents invalid address data from
being interpreted as a valid address.
Address:
72
DOMINION ROAD
RD
2
UNIT
2-72 DOMINION ROAD
UNIT 2
The engine will still return the Fault code and Info codes as in previous versions.
Input
line1:
George APHTHEMIOS
line2:
122A Smith
line3:
Delfon 20
line4:
145 71 N. ERYTHREA
line5:
GREECE
Version 7.80c
EXTRA9:
EXTRA10:
EXTRA11:
EXTRA12:
Country Name:
Country Code Numeric:
Country Code Alpha2:
GEORGE APHTHEMIOS
122A SMITH
DELFON 20
145 71 N ERYTHREA
GREECE
300
GR
Assignment changes
21
Page 22
22
International ACE Release Notes
Loading...