Activating LACSLink in Callable Mode - Code-1_Plus - 5.0

CODE-1 Plus Guide for IBM i

Product type
Software
Portfolio
Verify
Product family
Data Quality - Postals
Product
CODE-1 Plus
Version
5.0
Language
English
Product name
CODE-1 Plus
Title
CODE-1 Plus Guide for IBM i
Copyright
2024
First publish date
1998
ft:lastEdition
2024-05-15
ft:lastPublication
2024-05-15T00:03:43.588945

To use LACSLink when calling C1MATCHI from your own driver, one of three conditions must be returned from C1MATCHI:

  • The matched P9O output address has a LACS indicator from the database (P9OLACS)

  • The P9O General Return Code is not set to blank, B, or X in the output area (P9OGRC)

  • The P9O default record indicator and the USPS record type are returning a value of "R" in the output area (P9ODFR and P9ORTP).

To activate LACSLink in callable mode, call the CODE-1 Plus matcher and set the LACSLink indicator as shown below.

Position

Name

Length

Contents

40

P9I-ZLACS

1

This field allows you to specify if you want to perform LACSLink processing.

Blank   Do not attempt to perform LACSLink processing (default)

Y   Perform LACSLink processing

L   Invoke limited LACSLink subsystem processing. Provides the CODE-1 Plus non-LACS converted street address, city, and state data to the output standardized address and parsed elements fields

491-500

P9IDBL

10

Database library name.

491-500

N/A

10

These bytes are reserved for the Midrange environment.

491-500

P9IDBL

10

Database library name.

The following field has been added to the P9OUT call area structure.

Position

Field Name

Length

Comments

1215

P9OLACSLINK-IND

1

Indicates if a table was matched:

Blank   No LACS processing occurred.

F   LACS seed violation has occurred.

N   No match occurred or a new address would not convert at run time.

S   Input address contained both primary and secondary information but match occurred using only primary information.

Y   Full match occurred.

1216-1217

P9OLACSLINK-RC

2

Indicates the success of the LACSLink process:

Blank   No LACS processing occurred.

A   LACS record match.

00   No match.

0   Address was passed to LACS process, but could not be coded by LACS.

1   Address was successfully coded through the LACS process.

2   A LACS False/Positive record was encountered, but software is operating in a NCOA/No Stop Capacity. As such, NCOA/No Stop Capacity allows for the LACS function to continue processing when a seed record is encountered.

09   LACSLink was able to find the input address on its internal tables but for some reason did not return the new (converted) address.

14   Match found LACS record but would not convert.

92   Match with secondary information.

1218-1226

P9OLACSLINK-DB-INFO

9

Indicates the date of the database in YYYYMM format. Also contains error codes for LACSLink. If the value of P9OERR is "K" then the first five bytes of this field contain the error code.

20120: LACS DB EXPIRATION

20121: CAN'T OPEN SECURITY FILE

20122: CORRUPTED SECURITY FILE

20123: CHECK DIGIT VIOLATION ON SECURITY KEY

20124: PREVIOUS SEED VIOLATION, SYSTEM LOCKED

20126: RESTART KEY OR SECURITY FILE NOT CORRECT

20127: UNKNOWN

30000: LACS SEED VIOLATION

31000: LACS SYSTEM ERROR

32000: UNKNOWN as due to missing or corrupted LACSLink security file or key file.

1227-1239

P9OLACSLINK-VERSION

13

Version number of the LACSLink database.