- 1. What does the error 'Error opening PAF files: ATLAS Error 05. File ADDR Errno 2' mean?
- 2. What does 'Unable to load DLL 'xxxxxxxx.dll' The specified module could not be found' mean?
- 3. What does 'atlpaffh / nnn: Failed to find version record in atladdrc!' mean?
- 4. Where can I find samples to get me started?
- 5. What are the main addressing modules and their application?
- 6. Why am I not getting the match I expect from one of the above Hopewiser modules?
- 7. Why do I get 'Error opening PAF files: ATLAS Error 90...' returned having opened the datafiles?
- 8. Further Details
1. What does the error 'Error opening PAF files: ATLAS Error 05. File ADDR Errno 2' mean?
This denotes an inability to locate the reference files to be used (usually the Royal Mail PAF dataset) in the project you have established. Correcting this involves stating a correct path (or a variable containing this string) to the project file open statement. The PAF files should figure on the release media. They are the ones that are prefixed 'atl' and end in 'c'.
2. What does 'Unable to load DLL 'xxxxxxxx.dll' The specified module could not be found' mean?
This error implies that the atlas32a.dll or rplus32a.dll cannot be located by the wrapper dll (COM Server/.NET) at run time for AtlasCapture and AtlasRains integrations respectively. These are the core DLLs which contain all the address matching/lookup functionality. To resolve, please ensure that these dlls are firstly installed, then included on the Windows System Environment Variable called 'path' (located through Control Panel|System|Advanced). This is how the core DLLs are located at run time.
3. What does 'atlpaffh / nnn: Failed to find version record in atladdrc!' mean?
This error implies that the datafiles referenced within the project concerned (the path to these is defined at run time within the file open call) have been located, but these files have somehow become corrupted. To resolve this error, you should refresh the files concerned (those prefixed 'atl' and ending in 'c') from the latest Hopewiser release made to you.
4. Where can I find samples to get me started?
Project samples can be found within the release CD Atlas3Dev or RPlus3Dev folders (for AtlasCapture and AtlasRains products respectively). These folders contain sub-folders according to the method and technology/language used in the deployment. The folder names should make the required samples apparent. API sample folders have simple text files which denote installation and configuration steps. For more specific application details (what function does what, for example), please refer to the programmers reference guide PDF on the root of the CD.
5. What are the main addressing modules and their application?
AH21PCIX - Postcode (and optional premise) to address
AH23CODE - Partial address validation
AH28PFGZ - Street gazetteer
AH41GCTZ - Locality gazetteer
AH43PHGZ - Premise gazetteer
AH48ADPT - Address label formatter
6. Why am I not getting the match I expect from one of the above Hopewiser modules?
The first step here is to assess the returned status code from the call concerned and look this up in the pertinent Atlas Programmers Reference Guide chapter associated with this module. A 00 or 0 denotes a match or successful completion. Different modules report different status codes according to other lookup/processing states.
7. Why do I get 'Error opening PAF files: ATLAS Error 90...' returned having opened the datafiles?
This format of message (returned through the 'GetErrorInfo()' function in C) indicates a problem with the licence activation mechanism of the software which accompanies the release made to you. Please refer to the Licensing Status Codes.
8. Further Details
Hopewiser Developer Toolkits include two levels of documentation: text files covering set up and configuration information conveniently situated in the pertinent developer toolkit folder being utilised, and Programmers Reference Manuals situated in the root of the developer toolkit concerned ('atlas3dev' for AtlasCapture, and 'rplus3dev' for AtlasRains). If you cannot find the answer you seek in any of these documents, please contact Hopewiser technical support on 0161 924 2801 or firstname.lastname@example.org.