What is C1CTYLKx? - Code-1_Plus - 5.0

CODE-1 Plus Reference for all Platforms
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 Reference for all Platforms
Copyright
2024
First publish date
1998
Last edition
2024-05-15
Last publish date
2024-05-15T00:07:55.920704

There are two versions of C1CTYLKx:

  • C1CTYLKP (COBOL)

  • C1CTYLKC (CICS)

Note: iOn IBM i, the COBOL version is called SMCTYC, and the ILE RPG version is SMCTYR.

You can call the C1CTYLKP COBOL subroutine from your own program. C1CTYLKP uses your copy of the CODE-1 Plus database to match ZIP Codes to city/state combinations. You can use C1CTYLKP to have CODE-1 Plus:

  • Retrieve a city/state for a given ZIP Code.

  • Retrieve a ZIP Code for a given city/state (see important restrictions below).

  • Verify that a given ZIP Code and city/state combination is correct.

  • Retrieve detailed information for a given city/state including the short city name.

C1CTYLKC performs the identical functions on the CICS platform.

Note: iC1CTYLKx can return a correct ZIP Code for a given city/state only if the city/state has a unique ZIP Code. Many cities are assigned more than one ZIP Code. In this case, C1CTYLKx returns the lowest ZIP Code in the range of the ZIP Codes for the input city/state and all ZIP Codes that the city/state falls within. This answer must be considered unreliable because C1CTYLKx has no way to determine the correct ZIP Code. In this situation, the only reliable information returned is the short city name, long city name, and state abbreviation. For the best performance, sort your input file in ZIP Code sequence before running the input file through C1CTYLKx. If this is not possible, sort the input file by city name to produce the next best performance level.

C1CTYLKx can provide three different functions, depending upon the type of data that is passed from the calling program. The functions for each data type are described in the following sections.