Installation and Getting Started Guide (On-Premises)

5.15.0
- 5.9.0
- 5.8.1
- 5.8.0
- 5.16.4
- 5.16.3
- 5.16.2
- 5.16.1
- 5.16.0
- 5.14.0
- 5.13.0
- 5.12.0
- 5.11.0
- 5.10.0

Back Next

Initializing Informatica Address Verification

Before you can start processing addresses using Informatica Address Verification, you must initialize Address Verification by calling the

AD_Initialize()

function. For

AD_Initialize()

to succeed, you must include a valid unlock code and the path to the corresponding reference address database in the

setconfig.xml

file. After you finish processing the addresses, call

AD_DeInitialize()

to deinitialize Address Verification.

This topic shows the C function calls. If you are using Java or other implementations of Address Verification, use the corresponding function calls.

Prerequisites

Before you call

AD_Initialize()

, complete the following prerequisites:

Install Address Verification.

Download reference address databases and extract the contents to a location on the device on which you install Address Verification.

Update

SetConfig.xml

to include at least one valid unlock code and the path to the corresponding reference address database.

If you are using the Java API, set the

Encoding

and

WriteXMLEncoding

attributes of Input and Result elements in

Parameters.xml

and

SetConfig.xml

to UTF-16.

Calling Initialization and Deinitialization Functions

Call the Address Verification initialization and deinitialization functions in the following sequence:

To initialize Address Verification, call

AD_Initialize()

verifies the settings and configures Address Verification accordingly. You can call other functions such as

AD_GetAddressObject()

only after

AD_Initialize()

finishes successfully. .

To release

AddressObjects

after you complete address processing, call

AD_ReleaseAddressObject()

To deinitialize Address Verification, call

AD_DeInitialize()

. You can call

AD_DeInitialize()

only after you call

AD_ReleaseAddressObject()

After the successful completion of

AD_DeInitialize()

, Address Verification is ready to be initialized again.

Rules and Guidelines for Initialization and Deinitialization

Consider the following rules and guidelines when you initialize and deinitialize Address Verification to process an address:

When you call AD_Initialize in C or AddressDoctor.initialize in Java, the time to initialize depends on the number of files to open and the level of preloading involved.

For example, if you have BATCH_INTERACTIVE reference data files and a worldwide license, initialization might take 30 seconds. If you have a complete set of reference data files, including FASTCOMPLETION, GEOCODING, and other files, initialization might take one minute.

The sample times refer to a fast CPU and local solid state disk storage. The complete data file size is approximately 40 GB.

Due to the time to initialize, and because the processing time for a single address is in the millisecond range, Informatica strongly recommends that you initialize the engine when the customer program starts up. Also, errors and warnings can occur when you initialize the engine that do not occur later at other times. Deinitialize the engine when the customer program shuts down.

Rename Saved Search

Table of Contents

Installation and Getting Started Guide (On-Premises)

Installation and Getting Started Guide (On-Premises)

Initializing Informatica Address Verification

Initializing Informatica Address Verification

Prerequisites

Calling Initialization and Deinitialization Functions

Rules and Guidelines for Initialization and Deinitialization