If you are using Local data, as apposed to our internet based database, then you need to specify where the data file and license is.
We recommend you use our web based address data for initial testing. Then when happy download and install the local data files.
VB.NET LMSetDataPath "X:\PAFDATA" SetDataKey "I"
LMSetDataPath "X:\PAFDATA" SetDataKey "I"
When in local mode the Datakey is irrelevant, since the license is defined by the code entered in manager.exe (License manager, located in "X:\PAFDATA" in the above example). But we must specify “I” or “W” for Internal or External use.
(105 Mb, expands to 500Mb updated monthly)
(43 Mb, expands to 240Mb updated monthly)
(45 Mb, expands to 270Mb updated yearly)
Unzip the downloaded files to an appropriate directory. If on a network, install in a shared location, so all PC’s can see the data. Client PC’s will need full access rights to this directory.
Important : The software CANNOT BE MOVED after a license has been applied.
Run MANAGER.exe at the customers site, this will display a window with a red box in it. This program can be found in the "NET assembly" folder of example code. Press [Add New License] button. This is the SITE CODE, take a note of this code, as it is used to identify the site.
Next purchase an Internal user license using the online account, from within the Customers account. Use your “Reseller >> Customer” tab to access customers account. Skip this section for a 30 day Evaluation period. An invoice will then be sent either to you or the customer, and the commission accounted for depending on your reseller configuration.
Next get an activation code, by ringing us, on 01945 464854, quoting the Site code and License ID, or Contact us by clicking here.
Enter activation code in green box within manager.exe
Note for Resellers : We can allow you as a reseller to create the above activation code yourself. Please ring us on 01945 464854 for more details.
An e-mail is sent, to the registered e-mail account, when updates are ready for download.
The new data file is simply downloaded, and copied in to the specified loacl data directory.
In addition to the COM object, we also provide an optimised Royal Mail PAF file data which is available to “Large Business Package” customers. Please call for prices.
Your program can access the last date updated using:
LMGetLastUpdateDate(DataType as string) as string where DataType = F (full), T (thoroughfare) or Z (PostZon)
This returns the data the data was last updated in YYYYMMDD format. Your program could check this and ask to update, if older than 6 months for thoroughfare and PostZon, or 2 months for FULL PAF address data
The License is usually managed through the use of the MANAGER.EXE program. But the programmer can incorporate the License functionality in their own application, using the calls:
LMGetSiteCode() as string LMGetLicenseID() as Long
This returns a code. This code should be displayed, and the user quotes this number to obtain an "UnlockCode". This code is used to identify the "Site", so the code cannot be used on another network or machine.
LMTryUnlockCode(UnlockCode as string) as string
Returns "OK : Summary of License" or Error description for display, if unlock is invalid. So test for "OK" at start of string, meaning the license has been accepted.
LMGetLicienseInfo() as string
This function returns the status of data and license and should be displayed within the host application in a large text box
Typical Output: System: MDAC Version:2.0.0 Data is on Machine:DEV6 License ID:16240
System: MDAC Version:2.0.0 Data is on Machine:DEV6 License ID:16240
Licenses: Eval ALL DATA:Internal Use:5 users, expires 28 Jun 2007, ALL Areas
Data Status: Full PAF data present, Last updated:May 2007 5 Internal Use users, Eval area ALL
Thorughfare (Street) PAF data present, Last updated:May 2007 5 Internal Use users, Eval area ALL
PostZon data present, Last updated:May 2007 5 Internal Use users, Eval area ALL
Users: PostZon DEV6 Full DEV6 Street DEV6