Getting Started

Getting Started

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.