Matchcode

Example Name: McInter

Language: Java

API type: Java

API component filename: capscan.jar

Environment: Java 1.4 or higher

What does it do?

Demonstrates the use of, communicating with the Capscan Pool Manager, searching using Cross Match, Single Search, Rapid Addressing (searching using a postcode) and Quick Browse, Focusing, Selecting and working with ambiguity lists and additional data-sets.

This example is designed to work with both UK and international PAF files.

Could be used as a starting point for:

Creating an application to capture or verify a UK and/or international addresses, where you may need to have more of a flexible search option, EG: Organisation, Street…etc.

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\Java\Examples\McInter

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?

McInter.java Source code for the example.

Preparing to run the example:

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

Running the example:

1. Open a Command Prompt.

2. cd "C:\Program Files\Capscan\SDK\Matchcode Client\Java\Examples\McInter"

3. Make sure capscan.jar and the example directory is in the CLASSPATH.

4. javac McInter.java

5. java McInter hostname poolname

6. Once you have connected to the Capscan Pool Manager you will presented with prompt where you can enter a search to run.

7. The "help" command displays a list of commands. When followed by a command name it displays a description of that command.

8. The "columns" command displays a list of available fields.

9. The "select" command runs a search. Below is an example of a select command.

SELECT addr,listcount,ambiglist,searchstatus FROM xmatch WHERE addr="grand union house, 20 kentish town road"

10. This search will produce an ambiguity list. To select an item from the list run the following search:

SELECT addr,listcount,ambiglist,searchstatus FROM select WHERE searchstatus="x:ADDR=GRAND UNION HOUSE, 20 KENTISH TOWN ROAD",listitem="1"

11. To exit use the command "exit".

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.