Calling the GCP20 program - 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

The program GCP20 compares two input latitude/longitude coordinates to GeoTAX and calculates the distance between these points.

Use the following command to invoke the GCP20 distance calculation program:

CALL GCP20 USING DSIIN
   DSOOUT

Your calling program must pass the following parameters to GCP20.

Parameter Area

Parameter Area Name

Description

Input

DSIIN

100-character input area consisting of subfields (DSIxxx) that contain input information and processing requirements.

Output

DSOOUT

50-character output area consisting of subfields (DSOxxx) that contain processing results and return codes.

DSIIN Input Parameter Area 

The following table describes the subfields in the DSIIN input parameter area.
Position Name Length Contents
1 DSIFNC 1

Field that your program fills in:

E   End of job indicator: Nothing is stored in the output area. The calling program must clear active memory.

blank   GCP20 performs the distance calculation.

Other values are treated as blanks.

2-10 Reserved 9  
11-18 DSILAT1 8

Latitude of the first coordinate. The first 7 positions must contain the latitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional: N or S (North or South).

Example: The latitude coordinate 39 degrees, 30 minutes, North, is expressed as 0395000N.

19-26 DSILNG1 8

Longitude of the first coordinate. The first 7 positions must contain the longitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional associated with the longitude: E or W (East or West) of Greenwich, England.

Example: The longitude coordinate, 57 degrees, 15 minutes, West, is expressed as 0572500W.

27-34

DSILAT2 8

Latitude of the second coordinate. The first 7 positions must contain the latitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional: N or S (North or South).

35-42 DSILNG2   Longitude of the second coordinate. The first 7 positions must contain the longitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional associated with the longitude: E or W (East or West) of Greenwich, England.
43-`00 Reserved 58  
The DSOOUT Output Parameter Area

The following table describes the subfields in the DSOOUT Output Parameter Area.

Position

Name

Length

Contents

1-8

DSODST

8

Distance between the 2 input coordinates described in the input parameter. This distance is expressed in miles, accurate to one one-thousandth of a mile (.001). If the distance cannot be calculated, this field contains spaces.

NOTE: If no output distance is calculated, it is likely that an input error occurred. Check your coordinates, and try again.

9-50

Reserved

42