Matchcode

 

Example Name:                              XMatch.asp

 

Language:                                       HTML/ASP

 

API type:                                           ActiveX

 

API component filename:            McClicon.dll

 

Environment:                                  Windows 2000, XP, Vista

 

 

What does it do?

 

Demonstrates the use of, communicating with the Capscan Pool Manager and searching using Cross Match from an ASP web page.

 

This example is designed to work with the UK PAF file.

 

 

Could be used as a starting point for:

 

Creating a web page to capture or verify a UK address using a partial address.   

 

 

Where to find the example code:

 

After running the setup from the Matchcode CD to install the client APIs you will find these examples installed (by default) in:

 

C:\Program Files\Capscan\SDK\Matchcode Client API\ActiveX\Examples\asp

 

If you have installed to another location you will need to change the path where necessary.

 

 

What each file does:

 

File name                                         What does it do?

 

Default.asp                                           Get the input address and passes it to the main ASP page.

 

XMatch.asp                                          The main ASP page which calls the ActiveX methods and displays the results.

 

Spider.ini                                              Capscan Client/Server configuration file.

 

 

 

Preparing to run the example:

 

Please make sure that you have installed the Capscan Pool Manager and that it is up and running.

 

You will need to register the ActiveX control before you can use it.  To do this:

 

1.       Open a DOS prompt in the same folder as McClicon.dll.

 

2.       At the prompt type in the following and press enter:

 

        regsvr32 mcclicon.dll

 

 

Running the example:

 

1.       Make sure that the API library is in the search path.

 

2.       Make sure that the correct host name is set in the local spider.ini file.

 

3.       Copy XMatch.asp and Default.asp to the wwwroot folder.

 

4.       Make sure that the Default.asp page is set up to launch the XMatch.asp page.

 

5.       Open Internet Explorer and enter HTTP://themachinename/default.asp.  Where “themachinename” is the name of the machine that has the wwwroot folder with the ASP pages.

 

6.       When the default page has loaded, enter a postcode and click the Submit button.  The results of the search should appear on a new page.

 

 

Trouble-shooting and hints:

 

1.       If you are running on a LAN make sure that the Capscan Pool Manager is running correctly.  To do this you can use the PoolMan Admin application that is installed along with the Capscan Pool Manager.

 

2.       If you are using a firewall make sure that it is not blocking this example or the Capscan Pool Manager.  By default the Capscan Client/Server uses port 27920 for sending and receiving data.

 

3.       Try installing and running the Matchcode DC application to test that the Capscan Pool Manger is working correctly.  The installation for Matchcode DC can be found on the CD under:

 

Api\mcd_cs\win32\client\dc.

 

4.       For more hints and tips please see the SDK bookshelf documentation.