Integrating PER/ZIP4 into your application programs
Integrating PER/ZIP4 into your own software is a relatively easy process. We provide sample source code which provides examples of all the code you'll need. The sample source code is stored in source file QSMPLSRC in library MLLIBR.
In addition, other sample source code is provided in MULIB, a sample library provided with PER/ZIP4. MULIB is a complete system including menu, CL programs, and RPG programs to illustrate the use of PER/ZIP4.
Here is a summary of the callable programs (or API's, Application Program Interface).
ML2170 - Printing POSTNET Barcodes
Program ML2170 provides translation from the POSTNET numbers into the POSTNET characters. ML2170 is for use with the 5262/6262 or 4214/5224/5225 series printers. Translation tables and all the code you'll need are provided.
ML2172 - Delivery Address Abbreviation
Sometimes it is necessary to further abbreviate a delivery address after it has been standardized. ML2172 lets you specify the desired length of the delivery address line. If the address can be compressed to the desired length, it will be done. If it cannot be compressed to the desired length, no change will be made.
ML218101 - City/State Lookup Program
Program 218101 allows you to use the ZIP Code to retrieve the preferred city name along with the state code. The county name and FIPS (Federal Information Processing Standards) code along with several codes specific to the US Postal Service are also provided.
ML218201 - City/State Lookup Program
Program 218201 is an enhanced city/state lookup program. ML218201 allows you to use the ZIP Code to retrieve all the city names associated with the ZIP Code along with the state code. The county name and FIPS (Federal Information Processing Standards) code along with several codes specific to the US Postal Service are also provided.
ML2190RN - Batch Postal Coding
Program ML2190RN allows you to call the PER/ZIP4 batch postal coding program. Typically this is used to add a batch run to some process, such as an accounts receivable billing run. Using ML2190RN is the same as using the menu option for postal coding.
ML219302 - Browse the Postal Database
This program allows you to add the interactive browse of the postal database to your applications. Often you will want to allow your users to browse the database without allowing them access to the PER/ZIP4 menu. A call to ML219302 allows you to do this.
Browsing the postal database allows you to see all the city name, all the street names, and all the address ranges for each street. This is an invaluable tool for address correction.
ML219402 - Postal Coding in a user program
One of the most desirable features users want is the ability to verify and postal code addresses in an interactive program. ML219402 allows you to do this. No screens are involved, only the call to the program with the address information passed as parameters. The result is that the postal coded address is returned in the parameter list.