Migrating from CI to Native - Finalist - 10.0

Finalist Compatibility Interface (CI) Migration Guide

Product type
Software
Portfolio
Verify
Product family
Data Quality - Postals
Product
Finalist
Version
10.0
Language
English
Product name
Finalist
Title
Finalist Compatibility Interface (CI) Migration Guide
Copyright
2023
First publish date
1998
ft:lastEdition
2024-05-15
ft:lastPublication
2024-05-15T00:18:43.325870

The original intent was for the CI to be a short lived, temporary resource that would provide Finalist mainframe customers with time to migrate, test, and become familiar with the new Finalist native interface. This section describes the easiest path to migrate from the CI to the native interface. The Finalist CI has a variety of names that are essentially aliases of each other. These names include FINAL, FINALOL, FINALI, LPFN000, and others. The CI should not be confused with the Finalist LPAM database access routines. LPAM is a separate callable interface (API) that is not addressed in this document.

The Finalist CI passes one parameter to the interface. The callarea parameter is defined by the COBOL copybook LPFNCL01 (BAL uses the copybook LPFNCL04, C uses LPFNCL0C). The callarea is 10,000 bytes long. This parameter serves multiple definitions depending on what function is being performed. By contrast, the Finalist native interface uses dedicated parameters for each function call (API).

The CI consists of three calls.

CI Call

Description

Initialize (0)

Initializes the Finalist environment based on setup parameters.

Process (4, 5, 6, or 7)

Cleanses an individual address and returns information about the address. In early Finalist versions, the 4, 5, 6, and 7 calls were different. These calls are now identical.

Terminate (9)

Terminates the Finalist environment, frees storage, and produces reports.

Each CI call is described in detail in the following sections.

Note: Prior to the 8.3 release of Finalist, COBOL applications on the mainframe were required to compile with special options to be able to call the Finalist native interface. Starting with the 8.3 release, that limitation was eliminated.