Migrating the Initialize (0) Call - 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

This migration table maps the CI Initialize callarea to the Finalist native APIs and structures. Most of the CI information in this table maps to the Finalist native PBFNInit call. Section B information on the USPS Form 3553 (CASS Summary Report) is passed in the PBFNReportData (PBFNRDAT) structure of the PBFNTerminate call as noted below. The native structures, fields, and any special notes are identified in the third column.

COBOL (LPFNCL01)

C (LPFNCL0C)

Assembler (LPFNCL04)

Position

CI Structure/Field/Notes

FINAL_FILLER

LAnchorPointers

$REREGS

1-12

 

FINAL-FUNCTION-CODE

cFunctionCode[0]

FUNCODE

13-13

 

FINAL-FUNCTION-OPTION

n/a

CATAILOR

14-16

 

CALL-INIT

CallInit

CALLINIT

17-28

 

INITMOD

CaInitMod

INITMOD

17-24

 

INITBUFF

LInitBuff

INITBUFF

25-28

PBFN-GCFG-CACHE-SIZE

PBFNSetupDef.cCacheSize

CALL-CICS

CallCics

CALLCICS

17-28

 

CAMODNAM

CaModName

CAMODNAM

17-24

 

CAEXCPSW

CExcpSw

CAEXCPSW

25

 

CALL-IMS

CallIms

CALL-IMS

17-28

 

IMS-INITMOD

 

IMS-INITMOD

17-24

 

IMS-INITDAT

pPSBData

@PBSDATA

17-20

PBFNSetupDef.pPSBData

PBFN-GCFG-PPSBDATA

IMS-INITCITY

pPSBCity

@PBSCITY

21-24

PBFNSetupDef.pPSBCity

PBFN-GCFG-PPSBCITY

IMS-ALT-BLKSIZE

LAItBlkSz

ALTBLKSZ

25-28

 

FINAL-CNFIG-ID

caConfigID

CNFIGID

29-36

PBFN-GCFG-CASS-CONFIG-ID

PBFNSetupDef.cCASSConfiguration

If your configuration setting is AAR, cAssignAbbrevCity=ON.

If your configuration setting is AAJ, cAssignAbbrevCity=OFF.

INIT-CITY

CInitCity

INITCITY

29

 

FINAL-UNIQUE-OPT

cTUniqueZip

TUNIQUE

29

 

FINAL-STRTHPON-OPT

cTStreetPhonetics

TSTRPHON

30

 

FINAL-FIRMCORR-OPT

cTFirmCorrection

TFRMCORR

31

 

FINAL-CITYPHONE-OPT

cTCityPhonetics

TCTYPHON

32

 

FINAL-WEIGHT-OPT

cTWeighting

TWEIGHT

33

 

FINAL-ZIPCORR-OPT

cTZipCorrection

TZIPCORR

34

PBFN-GCFG-ASSIGN-ZIP-OPT

PBFNSetupDef.cAssignZipCodes

FINAL-CITYCORR-OPT

cTCityCorrection

TCTYCORR

35

 

FINAL-STRCOSM-OPT

cTStreetCosmetics

TSTRCOSM

36

 

FINAL-FRMPRS-OPT

cTFirmParse

TFRMPRS

37

Firm return line logic is automatic. See the PBFNLabelDef structure for more information.

FINAL-UNITDES-OPT

cTUnitDesignator

TUNITDES

38

Unit designators are corrected and returned to the calling program in return unit fields. You can decide to use input or return field.

FINAL-CTYLONG-OPT

cTLongCityName

TCTYLONG

39

PBFN-GCFG-ABBREV-CITY-OPT PBFNSetupDef.cAssignAbbrevCity=N (Return long names returned in label line.)

Both long and short names returned on a process call in separate fields.

FINAL-ALSLBL-OPT

cTAliasLabelLine

TALSLBL

40

PBFN-GCFG-ALIAS-STRT-OPT

PBFNSetupDef.cRetAliStName=Y (Alias street names are returned in label line.)

Both base and alias street names are returned on a process call in separate fields.

FINAL-VSE1-PRT

caVSESysNo[0]

VSYSNO1

41-43

 

FINAL-VSE2-PRT

caVSESysNo[1]

VSYSNO2

44-46

 

FINAL-VSE3-PRT

caVSESysNo2]

VSYSNO3

47-49

 

FINAL-VSE4-PRT

caVSESysNo[3]

VSYSNO4

50-52

 

FINAL-VSE5-PRT

caVSESysNo[4]

VSYSNO5

53-55

 

FINAL-VSE6-PRT

caVSESysNo[5]

VSYSNO6

56-58

 

FINAL-VSE7-PRT

caVSESysNo[6]

VSYSNO7

59-61

 

FINAL-STAT-REPORT-OPTIONS

caOptions

CAFNSTAT

62-69

 

FINAL-REPORT-SELECT1-6

caSelect[0]-[5]

CARPT1-6

70-75

Address Detail Report turned on with I/O, Isol, and Info Reports. If any report option is set to "Y", you must set cAddrDtlRptInfo, cAddrDtlRptIsol, and cAddrDtlRptInfo to "ON". If FINAL-REPORTSELECT4 is set to "Y", you must set cAddrDtlRptSugg to "ON".

FINAL-FIRMLBL-OPT

caFirmLabel

TFRMLBL

76

PBFN-GCFG-RETINPUTFIRM

PBFNSetupDef.cRetInputFirm

FINAL-REPORT-KEY

caKey

CAKEY

77-116

 

FINAL-LOT-OPT

caLOT

CALOT

77

PBFN-GCFG-ASSIGNLOT

PBFNSetupDef.cAssignLOT

FINAL-REPORT-NTH

caNth

CARPTNTH

78-81

PBFN-GCFG-ADDRDTLRPTISOLNTHREC

PBFNSetupDef.lAddrDtlRptIsolNthRec

FINAL-REPORT-TITLE

caTitle

CARPTITL

82-116

PBFN-GCFG-RPTTITLE

PBFNSetupDef.cRptTitle

FINAL-REPORT1-MAX

lMaxReport[0]

CARP1MAX

117-120

PBFN-GCFG-ADDRDTLRPTISOLMAXREC

PBFNSetupDef.lAddrDtlRptIsolMaxRec

FINAL-REPORT2-MAX

lMaxReport[1]

CARP2MAX

121-124

The setting used by the first max field is the setting used for all max fields.

FINAL-REPORT3-MAX

lMaxReport[2]

CARP3MAX

125-128

The setting used by the first max field is the setting used for all max fields.

FINAL-REPORT4-MAX

lMaxReport[3]

CARP4MAX

129-132

The setting used by the first max field is the setting used for all max fields.

FINAL-REPORT5-MAX

lMaxReport[4]

CARP5MAX

133-136

The setting used by the first max field is the setting used for all max fields.

FINAL-REPORT6-MAX

lMaxReport[5]

CARP6MAX

137-140

The setting used by the first max field is the setting used for all max fields.

FINAL-NUMBER-OF-LINES

SNumLines

CALINES

141-142

PBFN-GCFG-ADDRDTLRPTISOLPG-LEN

PBFNSetupDef.lAddrDtlRptIsolPageLen

FINAL-3553-SECA1A

caA1A

SECA1A

143-174

PBFN-GCFG-CASSCOMP-NAME

PBFNSetupDef.cCASSCompName

FINAL-3553-SECA1B

caA1B

SECA1B

175-206

PBFN-GCFG-CASSPROD-NAME

PBFNSetupDef.cCASSProdName

FINAL-3553-SECA1C

caA1C

SECA1C

207-238

PBFN-GCFG-LOTCERTCOMP-NAME

PBFNSetupDef.cLOTCertCompName

FINAL-3553-SECA1D

caA1D

SECA1D

239-270

PBFN-GCFG-DPCCERTPROD-NAME

PBFNSetupDef.cDPCCertProdName

FINAL-3553-SECB1

caB1

SECB1

303-328

PBFN-RDAT-LISTPROCESSOR-NAMEPBFNReportData.ListProcessorName

Passed on the PBFNTerminate call.

FINAL-3553-SECB4

caB4

SECB4

329-354

PBFN-RDAT-LISTFILE-NAMEPBFNReportData.ListFileName

Passed on the PBFNTerminate call.

FINAL-3553-SECB5

caB5

SECB5

355-377

PBFN-RDAT-LISTNUMBERPBFNReportData.ListNumber

Passed on the PBFNTerminate call.

FINAL-3553-SECD3A

caD3A

SECD3A

378-415

PBFN-GCFG-MAILER-NAME

PBFNSetupDataDef.cMailerName

FINAL-3553-SECD3B

caD3B

SECD3B

416-453

PBFN-GCFG-MAILERADDRESS

PBFNSetupDataDef.cMailerAddress

FINAL-3553-SECD3C   

caD3C

SECD3C

454-491

PBFN-GCFG-MAILERCITYLINE

PBFNSetupDataDef.cMailerCityLine

FINAL-3553-SECD3D

caD3D

SECD3D

492-529

PBFN-GCFG-MAILERADDRESS2

PBFNSetupDataSet.cMailerAddress2

FINAL-3553-SECD3E

caD3E

SECD3E

530-567

PBFN-GCFG-MAILERADDRESS3

PBFNSetupDataSet.cMailerAddress3

FINAL-3553-SECD3F

caD3F

SECD3F

568-605

PBFN-GCFG-MAILERADDRESS4

PBFNSetupDataSet.cMailerAddress4

FINAL-DPV-OPT

caDPV

CADPV

726

PBFN-GCFG-ASSIGNDPV

PBFNSetupDataDef.cAssignDPV

FINAL-EWS-OPT

caEWS

CAEWS

727

PBFN-GCFG-ASSIGNEWS

PBFNSetupDataDef.cAssignEWS

FINAL-LLK-OPT   

caLLK

CALLK

728

PBFN-GCFG-ASSIGNLACSLINK

PBFNSetupDataDef.cAssignLACSLink

FINAL-DUAL-ADDR

cDualAddrSwt

CADUALAD

729

PBFN-GCFG-DUALADDRSWT

PBFNSetupDataDef.cDualAddrSwt

FINAL-DPV-BUF-SIZE

cDPVBufSize

CADPVBUF

733-736

PBFN-GCFG-DPVBUFSIZE

PBFNSetupDataDef.cDPVBufSize

FINAL-SLK-OPT

caSLK

CASLK

737

PBFN-GCFG-ASSIGNSUITELINK

PBFNSetupDataDef.cAssignSuiteLink

FINAL-ASM-OPT

caASM

CAASM

738

PBFN-GCFG-ALLSTREETMATCHING

PBFNSetupDataDef.cAllStreetMatching