Calling Z4CHANGE From Your Own Driver - 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

If you are using your own batch driver for CODE-1 Plus and you want to use the Z4CHANGE processing, use the following call area to invoke C1P430. A COBOL copybook of this area, Z4CPARM, is included with your installation.

Note: iThe C1PRPT callable report program does not print a USPS Form 3553 that reflects Z4CHANGE Option processing. If you want an automated Form 3553 facsimile, you must use the C1BM00 batch driver to run CODE-1 Plus.

The following table describes the Z4CHANGE Option call area layout:

Position

Name

Length

Contents

1

PARM-FUNCTION

1

Function code for this call. Your program must pass one of the following function codes:

  • O — Open the Z4CHANGE Option database and (optionally) check dates.

  • P — Process ZIP check request.

  • C — Close the Z4CHANGE Option database.

2-6

PARM-5-DIGIT ZIP

5

5-digit ZIP Code.

7-10

PARM-4-DIGIT ZIP

4

4-digit ZIP+4 Code.

11-16

PARM-DATE-CODED-VINTAGE YYYYMM format

6

If PARM-FUNCTION is set to O, your program must pass the date of the CODE-1 Plus database being used for this CODE-1 Plus run. This date will be compared to the date of the Z4CHANGE Option database to ensure that they are the same. CODE-1 Plus will then pass the vintage date on the Z4CHANGE Option database back to your calling program through this field.

If PARM-FUNCTION is set to P, your program must pass the date (in YYYYMM format) of the master file that was last used to match the record whose ZIP Code is now being checked.

If PARM-FUNCTION is set to C, this field is ignored.

NOTE:  This field uses a four-digit year in YYYY format.  If leading zeroes are passed in lieu of century, century will be calculated using the 80/20 rule.  That is, YY less than 80 will assume century=20, otherwise will assume century=19.

17-29

N/A

13

Reserved.

30-39

PARM-DBLIB

10

Name of the library that holds the Z4CHANGE Option master file. Used for AS/400 only.

40

PARM-RETURN-CODE

1

This 1-character field is filled by C1P430 after the ZIP Code is checked. One of the following codes will be placed in this field:

  • 0 — If PARM-FUNCTION is O, this means the file has been successfully opened and the dates match.If PARM-FUNCTION is P, this means the 9-digit ZIP Code has not been changed by the USPS since the last time the record was checked.If PARM-FUNCTION is C, this means the file has been closed.

  • 4 — If PARM-FUNCTION is O, this means the database was already opened.If PARM-FUNCTION is P, this means either the 9-digit ZIP Code has changed since the last time the record was checked, or the ZIP Code was not numeric.If PARM-FUNCTION is C, this means the file wasn't open, and therefore could not be closed.

  • 8 — If PARM-FUNCTION is O, this means the database could not be opened successfully, or the dates don't match.If PARM-FUNCTION is P, this means that the database was not open.If PARM-FUNCTION is C, this code is never returned.

41-65

Reserved

25

Reserved.