When you call C1CTYLKx, you must pass a ZIP Code, a city and state, or all of the above. In addition, you can set the Vanity City flag to "X" if you want to allow vanity city names to be returned. Finally, there is also a function code that should be set to "E" when making the last call to C1CTYLKx to have C1CTYLKx close its open files. This should be done after the last match attempt has been made, but before terminating the calling program.
A COBOL copy member called CSPRM is supplied with the CODE-1 Plus software. Please use this copy member when calling C1CTYLKx.
A sample driver, SMPLCKP, that calls the CICTYLKB program is distributed with the software.
For CICS, the logic is identical except for the call:
CALL C1CTYLKC' USING DFHEIBLK DFHCOMMAREA CS-PRM-DATA