Calling GeoTAX Under CICS - GeoTAX_Premium - 7 - 7.7

GeoTAX Premium for Windows, UNIX/Linux, and z/OS

Product type
Software
Portfolio
Verify
Product family
Geo Addressing
Product
GeoTAX Premium
Version
7.7
Language
English
Product name
GeoTAX Premium
Title
GeoTAX Premium for Windows, UNIX/Linux, and z/OS
Copyright
2023
First publish date
1998
ft:lastEdition
2023-10-19
ft:lastPublication
2023-10-19T16:49:54.924301

When you call a module, you must pass, as parameters, the names of pre-defined call areas. These call areas are blocks of memory containing data used by both your driver program and the callable module. Each call area has an associated specific map. These maps describe the data stored in each byte in the call area. Because these maps are specific, both the callable module and the driver program know where each piece of data is stored in the call area. Therefore, instead of passing all of the data between the driver and the callable module, the only parameter that is passed between the two programs is the name of the call area.

Note: If you are calling GeoTAX under CICS, you must pass a single 01-level call area.

Example Procedure Division for CICS

The following example procedure division shows the activity of calling GTMATI in a CICS environment. GTMATI is the interactive equivalent of the GTMATCH program.

COPY GTMATPRM.
77 GTMATCH-LEN PIC S9(4) COMP VALUE 8192.
 
MOVE SPACES TO MATCHER-PARAMETERS.
MOVE "O" TO MCA-FUNCTION-REQ.
MOVE SPACES TO MIA-STREET-1.
MOVE ADDRESS-1 TO MIA-STREET-1.
MOVE SPACES TO MIA-CITY.
MOVE CITY TO MIA-CITY.
MOVE STATE TO MIA-STATE.
MOVE ZIP-CODE TO MIA-ZIP.
MOVE ZIP4 TO MIA-Z4.
MOVE SPACES TO MATCHER-OUTPUT-AREA.
EXEC CICS LINK PROGRAM ('GTMATI')
COMMAREA (MATCHER-PARAMETERS)
LENGTH (GTMATCH-LEN)
END-EXEC.