How to Use the SSA-NAME3 Service Group Sample Programs
How to Use the SSA-NAME3 Service Group Sample Programs
The sample programs are intended to be a starting point for your own prototype development. You can either copy one of these programs and change it to your needs, or write your own program from scratch making reference to the pseudo code and to these programs.
The minimum that would need to be changed in these samples for your prototype is:
the database environment statements
the database and file structures:
you will have your own database and field names
the database field names:
are used in various places with in the program and will need to be changed to your requirements
the name of the SSA-NAME3 Service Group being Called:
you should use the Service Group generated for your country and population of data
.
the screen or form variables:
the samples are set up to get a person’s name, date of birth and street address from the screen as search and matching criteria, whereas you may have different needs.
Other changes, which may need to be made, are:
the name of the NAMESET service:
the samples are set up to run against a Person name population (NAMESETP), whereas you may want to run it against another population type, such as Company names (NAMESETC) or Street names (NAMESETS).
the
NAMESET
Function parameter can be varied to demonstrate different Search Strategies.
the name of the MATCH Scheme name:
the samples uses a Scheme which matches person name, date of birth and address, whereas you may have different data to match.
the length of the
SSA-NAME3-NAME-IN
field and the structure of the
SSA-NAME3-SCORE-SEARCH-DATA
and
SSA-NAME3-SCORE-FILE-DATA
fields.
the structure of candidate, match and sort arrays, which contain data from the database.
the sample programs are set up to use the 8-byte SSA-NAME3 Key format. If you will be using the 5- byte binary key format (recommended if your database and programming language can support binary keys) then the structure and lengths of the following NAMESET parameters will need to be changed:
SSA-NAME3-KEYS-STACK
and
SSA-NAME3-SEARCH-TABLE
.
The comments in the pseudo code also help identify what may need to be changed in these programs.