Open the file qawserve.ini in a non-formatting text editor. This file can be found in the same directory as the library files.

The standard default settings are listed under [QADefault]. This layout includes a setting called InstalledData, which can be used to check dataset installation. You should not need to alter it, but you should check that it meets your requirements.

InstalledData={identifier},{path}

Default

Must be explicitly set

Purpose

This keyword lists the installed datasets by a three letter identifier and location. These datasets are the ones installed by the setup program or copied across from the supplied data CDs/DVDs. If you wish to change or add to them, you should run the setup program again or copy them from the supplied medium. Note that if you are also using Additional Datasets, they do not need to be listed in this setting.

If you have more than one dataset installed, the first dataset appears directly after the = sign, and each subsequent dataset appears on a new line preceded by a + sign. For every line that you have specified here, you should also add a line in the DataMappings setting.

If you need to move a dataset, you should update this setting accordingly.

Example

If you have installed the UK, Australia, and Netherlands datasets in C:\Program Files\QAS\Data, this setting would appear as follows:

InstalledData=GBR,C:\Program Files\QAS\Data\
+AUS,C:\Program Files\QAS\Data\
+NLD,C:\Program Files\QAS\Data\

DataMappings={identifier},{dataset/group name},{dataset identifier+additional datasets}

Default

Must be explicitly set

Purpose

This keyword allows you to map combinations of datasets and additional datasets to use for different cleaning runs. You choose an identifier and dataset/group name then specify the dataset and related additional datasets you want to include for each mapping. The identifier must be a 3-character alphanumeric code.

If you want to set up more than one mapping, the first should appear directly after the = sign, and each subsequent mapping should appear on a new line preceded by a + sign. If you add or remove datasets in the InstalledData setting, you should update this setting accordingly.

If you specify multiple additional datasets, you can set the order of precedence with the DatasetPrecedenceOrder setting.

Example 1

If your InstalledData setting includes the UK, Australia and Netherlands datasets, and you also have the United Kingdom Names and Electricity additional datasets, and you want to search against different combinations of data simultaneously, you might use this setting as follows:

    DataMappings=GBR,United Kingdom,GBR
    +GBN,UK With Names,GBR+GBRNAM
    +GBE,UK With Electricity,GBR+GBRELC
    +GBA,UK With Names And Electricity,GBR+GBRNAM+GBRELC
    +AUS,Australia,AUS
    +NLD,Netherlands,NLD

Example 2 (when using GBR data with additional Suppression data)

If your InstalledData setting includes the UK dataset, and you also have the United Kingdom Suppression additional datasets, and you want to search against different combinations of data simultaneously, you might use this setting as follows:

    DataMappings=GBR,United Kingdom,GBR
    +GBS,United Kingdom With Suppression, GBR+GBRABC+GBRABS+GBRMSS+GBRNCA+GBRUSS+GBRMOR+GBRMPS
    +GBM,United Kingdom With Suppression Movers,GBR+GBRABC+GBRABS+GBRNCA+GBRUSS+GBRGSF
    +GBD,United Kingdom With Suppression Deceased,GBR+GBRMSS+GBRMOR+GBRUSS+GBRTBR
    +GBP,United Kingdom With Suppression Preferences,GBR+GBRMPS+GBRTPS

Example 3 (when using AUS data with additional Suppression data)

If your InstalledData setting includes the AUS dataset, and you also have the Australia With Suppression additional dataset, and you want to search against different combinations of data simultaneously, you might use this setting as follows:

    DataMappings=AUS,Australia,AUS
    +AUX,Australia With Suppression,AUS+AUSMOR

CorrectAApiLoc={path}

Default

Must be explicitly set

Purpose

This setting is required if you are using the USA or CAN data. The setting specifies the location of the certified address matching engine supplied on the supplementary USA or CAN Batch data disk (Windows) or separately (UNIX). You must ensure that {path} is the location of the directory containing "CorrectA.dll" (Windows) or the "libCorrectA " shared object file (UNIX).
You do not need to use this setting if the CorrectA library is in the same location as your core Batch API libraries.

Example

If the certified address matching engine was copied to the /Data/USA directory, you would use the following setting:

CorrectAApiLoc=/Data/USA

CorrectADataLocUSA={path}

Default

Must be explicitly set

Purpose

This setting is only required if you are using the USA data. The setting specifies the location of the supplementary USA Batch data files. The setting will be set by the installation program on the USA Batch data disk. If you are a UNIX user or copy the data files manually, you must ensure that {path} specifies the location of the parent directory containing the data files.

Example

If the supplementary USA Batch data was copied to the /Data/USA directory, you would use the following setting:

CorrectADataLocUSA=/Data/USA

CorrectADataLocCAN={path}

Default

Must be explicitly set

Purpose

This setting is only required for CAN data. It specifies the location of the supplementary CAN Batch data files. The setting will be set by the installation program on the CAN Batch data disk. If you are a UNIX user or copy the data files manually, you must ensure that {path} is the location of the parent directory containing the data files.

Example

If the supplementary CAN Batch data was copied to the /Data/CAN directory, you would use the following setting:

CorrectADataLocCAN=/Data/CAN

Batch API

Configuration