Dataset installation

The file qawserve.ini is used to specify which Primary Sourced datasets are available to Pro API, and the location in which they are installed.

To modify these settings, open the file qawserve.ini in a plain text editor. For Windows, this file can be found in the same directory as the library files: for UNIX, this file can be found in apps directory.

The configuration keywords used to configure datasets are InstalledData and DataMappings, located in the default section [QADefault] of the qawserve.ini file. You may need to add these settings if they do not already exist.

You can manually specify the location of the qawserve.ini file using the QAWSERVE environment variable QAWSERVE = path-name.

Format:

InstalledData={dataset identifier},{path}

Default:

Blank

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.

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\

If you need to move one or more of your datasets, you should update this setting accordingly.

Format:

PreviousInstalledData={dataset identifier},{path}

Default:

Blank

Purpose:

This keyword lists the previously installed datasets by a three letter identifier and location. When updating a dataset via the Administrator Console, this previously installed dataset is listed. This enables you to roll the product back to using a previously installed version of data.

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\

Format:

NewInstalledData={dataset identifier},{path}

Default:

Blank

Purpose:

This keyword lists the newly installed datasets by a three letter identifier and location. These datasets are the ones that have been installed but not yet updated to the server. The keyword is primarily used by the Administrator Console.

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\

Format:

DataMappings={data mapping identifier},{data mapping name},{base dataset}[+{additional dataset}]

Default:

Blank

Purpose:

This allows you to specify which datasets and additional datasets you are using, and what you want the identifier and name of each to be. These groupings are referred to as data mappings.

{data mapping identifier} is a 3-digit alphanumeric code, and {data mapping name} is a short text description of the mapping. You can specify both the data mapping identifier and the data mapping name. {base dataset} is the identifier of the base dataset, and may be followed by the + symbol and {additional dataset}, which is the identifier of an additional dataset.

If you add or remove datasets in the InstalledData setting, you should update this setting accordingly.

Example:

If your InstalledData setting includes the UK, Australia and Netherlands datasets, this setting could appear as follows:

DataMappings=GBR,United Kingdom,GBR

+Aus,Australia,Aus

+NLD,Netherlands,NLD